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0 FOREWORD 


This document describes the Reality assembly language instruction 
repertoire for Release D. 


Section 1 presents general information about classes and types of 
instructions. It also explains the format used in describing the 
instructions. 


Section 2 describes each instruction. The instructions are 
presented in alphabetical order according to their opcode 
mnemonics combined with their operand types. For example, the 
instruction MOV Wi,Wj would be in order according to the symbol 
MOVWW. 


The Index includes all of the instruction mnemonics'9 and the 
instruction opcodes. 
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INTRODUCTION 
1 INTRODUCTION 


The REALITY assembly language instruction set has been completely 
revised with the release 7.0. Many new instructions have been 
added to the repertoire and the object code has been radically 
changed. This document describes the executable instructions. It 
does not discuss assembler directives. 


1.1 INFORMATION COMMON TO SEVERAL INSTRUCTIONS 
This section discusses information that applies to different 


classes of instructions, such as arithmetic instructions, string 
instructions, and so forth. 
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INTRODUCTION 
1.1.1 ARITHMETIC AND ACF ALTERATIVE INSTRUCTIONS ) 


The arithmetic instructions perform arithmetic operations on the 
contents of accumulators or locations. These contents are 
loosely referred to as binary integers Since the bit 
configurations represent a binary integer. 


Some instructions perform their functions on the accumulators 
(element-to-accumulator or accumulator-to-element operations). 
Others perform their functions as element-to-element operations. 


The high-order bit of a binary integer is the sign bit. Zero in 
this bit means positive; one means negative. Negative values are 
represented in two's complement form. 


When an integer is loaded into the accumulator, the sign bit is 
extended to the left to fill the accumulator (either DQ or FPO - 
depending on the operation or operands). 


Each operand for an arithmetic instruction must lie entirely 
within a single frame. That is, all of the bytes of the operand 
must be in the same frame. 


Many of the arithmetic instructions set the Arithmetic Condition 
Flags (ACF). Whenever the ACF is updated, the entire byte is 
overwritten and bits not related to the instruction are undefined 
after the update. The instruction descriptions specify whethe: 

the ACF changed. | 


Element-to-element instructions do not use the accumulators, nor 
do they change the contents of the accumulators. Furthermore, 
they do not change the ACF. 


The names of the individual flags, their bit positions, and their 
meanings are as follows: 


Name Bit Description 


NUMBIT 1 Used by the ASCII-number-conversion instructions 
to indicate that a valid number was converted. 


VALBIT 2 Set by aASCII-number-conversion instructions to 
indicate that the maximum number of digits 
specified has been converted. 

EQUBIT 5 Set by the COMP instruction. 

LOWBIT 6 Set by the COMP instruction. 


OVFBIT 7 Set when the accumulator overflows (i.e., the 
result would not fit in the accumulator). 
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INTRODUCTION 
1.1.2 STRING MOVEMENT AND SCAN INSTRUCTIONS 


The string instructions may be used to move or scan character 
strings. A string is defined as a logically contiguous group of 
bytes that may extend across linked frame boundaries. The 
location of a string is indicated by an address register pointing 
at either the byte before or the byte after the string. The 
length of a string is controlled by either a count of the number 
of bytes in the string (count in TO control), a set of 
Characters which terminate the string (delimiter control), or 
another register pointing at the opposite end of the _ string 
(register control). In a move instruction the string destination 
is indicated by a register pointing at the byte before or the 
byte after the new location. 


Count in TQ Control. When count control is used in the string 
instructions, TO (the lower half of DO) is presumed to contain a 
count before the instruction is executed. The count is 
decremented before the instruction is executed. 


Delimiter Control. Delimiter control refers to the testing of 
the contents of a byte for a match with one of seven possible 
characters as defined by a match field (N) in the instruction. 
For an unsuccessful match, instruction execution is repeated. 


The set of characters tested in the match is defined by the match 
field and the SCO, SCl, and SC2 bytes in the PCB. For each bit 
position one through seven in the match field that is al,a 
match test is done. If bit position zero in the match field is a 
1, the instruction stops on the first equal match. If bit 
position zero is a 0, the instruction stops when the contents of 
a byte does not contain one of the characters specified in the 
match set. The table below shows the test done for each bit 
position in the match field. 


Bit Test Performed 

0 1 = stop on equal; 0 = stop on unequal 

1 1 = compare with X'FF', segment mark (SM) 

2 1 = compare with X'FE', attribute mark (AM) 
3 1 = compare wit.i X'FD', value mark (VM) 

4 1 = compare with X'FC', subvalue mark (SVM) 
5 1 = compare with contents of SCO 

6 1 = compare with contents of SCl 

7 1 = compare with contents of SC2 


Register Control. Address register 15 (R15) is used with 
register control string instructions. Before these instruc- 
tions are executed, R15 must have been loaded with the address 
of the last byte to be moved. The register pointing at the 
source string is incremented or decremented each time a 
character is moved. When the contents of the source register 
equal the contents of R15, execution ceases. 
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INTRODUCTION 


Cautions Regarding String Addressing. All the string ip 


Structions either increment or decrement the addresses of t 
source and destination bytes. Hence, it must be remembered that 
the address of a string must point to one byte before or one byte 
after the string. 


The requirement that the address register point to one byte 
before the string's first byte has some important ramifications 
when the string's first byte is the first byte of the frame. 
Three cases must be considered: the frame is the first frame in 
a linked set; the frame is in a linked set, but it is not the 
first frame; the frame is unlinked. 


Recall that the first data byte of a frame ina linked set 
requires a displacement of 1 in the address register. If the 
frame is ina linked set, referencing the byte before the first 
byte of the first frame requires an address with a displacement 
of zero. 


In the case of the frame being the first frame ina linked set, 
when this address is attached during the execution of a string 
instruction, the firmware takes into account that a string 
instruction is executing and attaches the address’ register to 
byte zero of the frame rather than causing a BACKWARD LINK ZERO 
trap to the debugger. When the address is incremented, the first 
data byte of the frame will be referenced. Thus, string 
instructions may reference the "byte before" of the first fram 
of a linked set without difficulty. | 


A linked frame other than the first presents a similar situation, 
but should be avoided. When an address register with a 
displacement of 0 is attached in this situation, the firmware can 
attach the register to point to the last byte of the previous 
frame. This means that the previous frame must be read into 
memory (if not already in memory) at the start of instruction 
execution. When the register contents are incremented by the 
string instruction, the frame containing the string must be read 
into memory. Hence, when a string instruction references the 
first data byte of a linked frame, other than the first frame, 
the previous frame will always be read into memory just to 
satisfy the attachment of zero displacement. For the sake of 
efficiency, avoid this situation whenever possible. 


When the string starts at byte zero of an unlinked frame (the 
first data byte), it is impossible to reference the previous 
byte. But byte zero can be referenced; therefore a string 
instruction can be used to handle the string starting at byte 
one. To move the contents of byte zero of an unlinked frame an 
instruction such as MCC Ri,Rj must be used. 


J 
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Cautions Regarding String Addressing (cont). When the 


decrementing string instructions are used at the last data byte 
of a frame, the results are analogous to the cases of the first 
data byte. In the case of the last data byte of the last frame of 
a iinked set, the byte cannot be referenced. Attempting to do so 
with a displacement of 501 will cause a FORWARD LINK ZERO trap to 
the Debug state. 


If the linked frame is not the last frame, referencing the last 
data byte will cause the next frame to be read into memory to 
Satisfy the attachment of the register (just as the previous one 
is read when the first byte is referenced). 


For an unlinked frame, the last data byte cannot be referenced 
with a decrementing string instruction. 


Once a string instruction has started execution, if the specified 
control does not stop execution properly, the addresses will be 
incremented or decremented until they reach one _ beyond the 
highest or one below the lowest allowed address. At that point 
one of the following Debug state traps will occur: 


FORWARD LINK ZERO - linked set of frames when incrementing 
BACKWARD LINK ZERO - linked set of frames when decrementing 


CROSSING FRAME LIMIT - nonlinked frame when either incrementing 
or decrementing. 
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INTRODUCTION 
1.1.3 SPECIAL ADDRESS REGISTERS 


Address registers 0 and 1 are used in special ways in the system. 
When referenced in an instruction, they should be used with the 
following information in mind. 


Address Register 0. Register 0 (RO) is used in a special way. 
This register always points to the PCB (i.e., byte 0 of the PCB). 


When a virtual process is not active, RO is in detached form and 
contains the frame number of the PCB in its FID field and 0 in 
its displacement field. 


Register 0 is attached when the process is activated. Thus, the 
attached register (RO) points to the (beginning of the) buffer in 
main memory where the PCB is being held. 


Address Register 1. When a process is not active, detached 
address register 1 (Rl) contains the virtual memory address minus 
l1 (i.e., the FID and displacement (minus one)) for the next 
instruction to be executed. Thus, Rl acts as a repository for the 
program instruction counter for that process between activations. 


When the process is started, the buffer address of the program 
frame (as determined from the buffer map) is added to the 
displacement from Rl. This value (a main memory address) is 
placed into a hardware instruction counter. The register is then 
converted to the attached form with the buffer address set to 
byte zero of the program frame. 


This allows Rl to be used as a base register to reference data in 
the program frame because, when the process is active, Rl points 
to byte 0 of the program frame (mode) in main memory. Never use 
Rl as a destination or to specify a destination. 


When the process is deactivated, the main memory address in the 
instruction counter is converted to the corresponding FID and 
displacement, and Rl is detached with these values in it. 


NOTE 
Never update data in an ABS frames using Rl. The data 


will not be written back to disk. It is best, never to 
change ABS by software. 
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INTRODUCTION 
1.1.4 STORAGE REGISTERS AND NORMALIZED ADDRESSES 


Storage Registers. A six-byte location used to contain a virtual 
storage address is called a storage register. 


The Load Address Register instruction moves six bytes from memory 
into bytes 2 through 7 of an address register after zeroing bytes 


QO and 1 of the register. Note that the address register is 
detached. As usual, the address register will have to be 
attached in order for the data referenced by the register to be 
accessed by the CPU. Correspondingly, with the Store Address 


Register instruction, the firmware takes the detached form of an 
address register and stores bytes 2 through 7 in a six-byte 
memory location (the contents of the address register do not 
change). In summary the storage register is a virtual storage 
location that contains a virtual storage address. 


Normalized and Unnormalized Addresses. A normalized address is 
one whose displacement is between 0 and 1023, inclusive, for an 
unlinked frame and between 1 and 1000, inclusive, for a linked 
frame. An address in an address register becomes unnormalized 
when the memory address is incremented, or decremented, beyond 
the buffer end. This causes the register to become detached with 
a displacement greater than a frame size or less than zero. When 
the register is attached, the address will be normalized by the 
firmware. 


If a detached address register is moved to a storage register, 
the storage register may contain an unnormalized address. This 
can cause errors if the storage register is used in a Compare 
Address Register instruction. The Attach Register instruction can 
be used to attach a register before its contents are moved to a 
storage register. 
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1.1.5 INSTRUCTIONS WITH OFFSET j 


Some instructions reference data by means of a base address 
register and an offset value within the instruction. When such an 
instruction is executed, each address register referencing data 
is attached. This means that the register's memory address field 
points to a byte ina memory buffer. The instruction's offset 
value and the contents of the memory address field are then added 
together ina firmware register to yield the effective address. 
Since the address register has been attached toa particular 
buffer, the effective address must point to a byte in that same 
buffer. Furthermore, the entire operand (either a bit or one, 
two, four or six bytes) must lie entirely within the buffer. 


Therefore, an instruction that references data by means of a 
register and an offset within the instruction must reference data 
that are entirely within the frame pointed to by the address 
register. Although it is possible to initialize a register to 
point to a frame (say to the end of the frame), and it is 
(conceptually) possible to use an instruction that references 
data by means of this register plus some large offset which would 
point to a byte in the next linked frame, the firmware cannot 
accommodate such an arrangement because the address register is 
attached to a buffer before the instruction offset value is added 
to form the effective address. A “CROSSING FRAME LIMIT” trap t~> 
the Debug state will result unless the instruction descriptic_) 
specifies otherwise. 
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1.2 INSTRUCTION DESCRIPTION FORMAT 


1.2.1 FORMAT OVERVIEW 


Each instruction is explained with a diagram and several specific 
items. Figure A shows the instruction diagram and the 
description items. Listed below are the explanations of the items 
and legends for what may appear under the rubrics. 


INSTRUCTION TITLE 


This gives the name of the instruction as it is commonly referred 
to in the text. The title is usually suggestive of the function 
of the instruction. 


MNEMONIC 

The source code symbol that represents the machine instruction. 
The mnemonic is the symbol that is used in the opcode field of 
the assembly language instruction. All the mnemonics) of the 
assembly language instructions are contained in the OSYM table. 

A lowercase c is used in a mnemonic to indicate a comparison code 
such as E for equal, LE for less than or equal, NZ for non zero. 


For example, BDc could be BDZ or BDNZ among other possibilities. 
See section COMPARE CODE INDICATORS. 


INSTRUCTION TITLE 


MNEMONIC {OPERAND1 {,OPERAND2 {,OPERAND3}}} 


INSTRUCTION TYPE 


| ’ ’ | ' { | 
1 ummm | xxx | XXX | XXNXX | XXXKX | XXXX | LENGTH IN 
| ( 0 t t t t BITS 

1 2 3 4 5 6 


Detailed Description of Instruction Execution 


Operand Object Code (in Hex) 
Types 
Example 


Cautions and Notes 


Figure A. Instruction Diagram and Description Items. 
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INTRODUCTION 
OPERANDS 
The types of operands that are allowed in the operand field of 


the assembly language instruction are represented by the 
following codes: 


A Absolute memory location 

B Bit reference 

C Character 

D Double tally 

F Triple tally (Full tally) 

H Half tally 

K Literal (represents a constant) 
L Location local to the frame 


(i.e., displacement within the program frame) 
Immediate data (constant) 

Address register 

Storage register 


Tally 


<« A Hn wD 24 


Three-byte value in the low-order bytes of a 
four-byte field 


W Representative symbol for any of the tally type 
operands. That is, when W appears as an 
operand, a half tally (H orC), tally (T), 
double tally (D), three-byte value (V), or 
triple tally (F or S) type operand may be valid 
in the assembly language instruction. 


The letters i and j are used to distinguish between two 
operands. In general the operand with the i is the source of data 
(the “from” field) and the j operand is the receiver of data (the 
"to" field). For example, the instruction MOV Wi,Wj moves data 
from the Wi operand to the Wj operand. On the other hand, 
instruction AND Rj,Ri forms the logical AND of the two operands 
and stores the result in the Rj operand. 


INSTRUCTION TYPE 
There are 13 instruction types. The instruction type is indicated 


just above the object code format display. See the section 
INSTRUCTION TYPES. 
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OBJECT CODE FORMAT ) 


The object code format is displayed in a diagram. The diagram 
breaks the format into four-bit fields (nibbles). 


The operation code bits are shown in binary representation. Other 
fields that have fixed numeric values are also shown in binary. 


Where an instruction allows more than one of the tally type 
operands, half-tally (H), character (C), tally (T), double tally 
(D), triple tally (F), storage register (S), and three-byte value 
(V), the operand is represented by a W. The symbols for these 
types of operands are defined with three data: base address 
register, offset from the address register, and size indicator. 
The position of these data in the object format is indicated by 
means of subcodes as follows: 


Wir Base address register for operand Wi 
Wid Offset from address register Wir 
Wik Size indicator of operand Wi (See the section 


OPERAND SIZE INDICATOR. ) 
Of course, Wj rather than Wi is used where appropriate. 


If an instruction requires a particular tally type > be used, 
only the code for that type is used to explain the -.struction. “* 
For example, the instruction READ Rj,Hi requires that the second 
operand be a half tally so H, not W, is used in the instruction 
description. 


Some other descriptor codes are as follows: 


f = FID (Frame Identification number) 
e = Entry point number 
c = Compare code indicator. The indicator is used in 


conditional branch instructons with meanings 
such as: less than, non- zero, equal, etc. See 
the section COMPARE CODE INDICATORS. 
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DETAILED DESCRIPTION OF INSTRUCTION EXECUTION 


This gives a full description of the instruction execution. The 
definitions of common terms are as follows: 


Load - The contents of some location replaces the contents 
of an address register or accumulator. 


Store - The contents of an address register or accumulator 
replaces the contents of some location. 


Move - The contents of a location replaces the contents of 
some other location, or the contents of a register replaces 
the contents of another register. 


Since most instructions change the contents of a location, 
register, or accumulator, the following symbols will be used 
often: 
C(element) means the content of an element. 
For example, 
C(Ri) means the content of address register Ri. The content 
of an address register is, of course, the address of some 
byte. 
C(C(Rj)) means the content of the content of address 
register Rj, that is, the content of a byte pointed to by 
the content of Rj. 


C(Wir) means the content of the base address register for 
operand Wi, that is, the address of a byte. 


C(Wir)+Wid means the address of a byte offset by Wid from 
the byte pointed to by address register Wir. 


C(C(Wjr)+Wjd) means the content of an element that is offset 
by Wjd from the byte pointed to by address register Wjr. 


The offset d is a byte offset for all tally-type elements. 


The size of the element is determined by the k field of the 
instruction for a tally type of operand. 
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LIST OF VALID OPERAND TYPES AND RESPECTIVE OBJECT CODE ) 


This is across reference to the object code listings of an 
assembly language program. The value of k is listed when 
appropriate, along with the associated valid operand types. The 
object code is given in hexadecimal notation and the nibble 
positions noted. 


EXAMPLES 

The operands are usually defined in the following artificial 
manner: HTYPI or HTYPJ for half-tally operands, CTYPI or CTYPJ 
for character type operands, TTYPI or TTYPJ for tally operands, 
etc. 


CAUTIONS AND NOTES 


Peculiarities regarding the instruction execution or caveats on 
instruction usage are noted. 


2 
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1.2.2 OPERAND LENGTH INDICATOR 
Cc The operand length indicator (k) occupies four bits. 


The length specifier indicates the following: 


k Operand Size Associated 
will be: Operand Type 

0) byte C,H 

1 tally T 

2 double tally D 

3 triple tally F,S 

7 four bytes V 

8-F bit B 


When k is 7, the operand size is four bytes but the data are the 
contents of the three low-order bytes of the four. 


When k is’ 8 or greater, the operand is a bit (B type) and _ the 
three low-order bits of k specify the offset of the bit in the 
addressed byte. 
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1.2.3 COMPARE CODE INDICATORS 


The compare code indicators are assembled into the c field of th 
indicates all possible conditions for 
both arithmetic, logical, and data type compares as follows: 


object code. The c 


Compare Type Mnemonic 


Arithmetic 


7 
oL 
1 
N 


>) 


Logical 


ta wN 


| 


Data Type 


cL2P CCl Etwaerw re 


NA 
NN 
NH 


The assembler's OSYM does 


Cc Lae 
GL 
WN 


C3 
C* 
| 
NS 


Meaning 


ALWAYS 

LESS THAN 

EQUAL 

HIGHER 

NEVER 

HIGHER THAN OR EQUAL 
UNEQUAL 

LESS THAN OR EQUAL 


BIT SET/ODD 

LESS THAN 

EQUAL 

HIGHER 

BIT CLEAR/EVEN 
HIGHER THAN OR EQUAL 
UNEQUAL 

LESS THAN OR EQUAL 


ALPHABETIC 
NUMERIC 
HEXADECIMAL 

NON ALPHABETIC 
NON NUMERIC 

NON HEXADECIMAL 


not have mnemonics 


NEVER. These combinations are for patching only. 


The mnemonics shown 
zero. 
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1-16 


Object Code 


0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 


1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


1000 
1001 
1001 
1100 
1101 
1101 


for ALWAYS 


in parentheses are used when comparing with 


J 


J 


INSTRUCTIONS 


2 INSTRUCTION SET REPERTOIRE 


¢ Each instruction in the repertoire is described on the following 
pages. 
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INSTRUCTIONS 


ADD TO ACCUMULATOR ) 
ADD Wi 


Type 5 Instruction 


{ { | { } 

' 1010 | 0011 ! Wir ! 0000 ! Wik | Wid i 39 

t { | | { I ] ! { BITS 
pa a ov cn a Sd Sie 


Detailed Description of Instruction Execution 

The integer addressed by the operand is added to the 32-bit 
accumulator (DO) with sign extension. That is; 
C(C(Wir)+Wid)+C(D0O) replaces C(DO). 


C(ACF) is updated to reflect overflow. 


Operand Wik Object Code (Hex 
Types — 22345678 
Hi 0 A3iO0d0dddad 
Ti 1 A3ioO0Olddd 
Di 2 A3Z3iOd2ddad wel” 
Vi 7 A3Z3iOodgvddad 
Example 
Label Opc Operand Comment 
Field Field Field Field 
ADD HTYPI 
ADD DTYPJ 


Programming Note: The mnemonic ADD may be used with F type 
operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction ADDx. 
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ADD TO EXTENDED ACCUMULATOR 
ADDX Wi 


Type 5 Instruction 


| { | j | 1 

' 1010 ! 0010 | wir | 0000 ! wik ! Wid i 39 

| j t | ' i | j ! BITS 
Sr aac 5 4 5 a ar 


Detailed Description of Instruction Execution 

C(C(Wir)+Wid) is added algebraically to C(FPO) and this sum re- 
places C(FPOQ). That is, C(C(Wir)+Wid)+C( FPO) replaces 
C(FPOQ). 


C(ACF) is updated to reflect overflow. 


Operand Wik Object Code (Hex) 
5 67 


Types 12345678 
Hi 0 A2idoddd 
Ti 1 A2ioOdlddd 
Di 2 A2ioO2z2ddd 
Fi 3 A2iod3dadd 
Vi 7 A2iod?7v?ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
ADDX DTYPI ADD DOUBLE WORD TO FPO 
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INSTRUCTIONS 


AND WITH IMMEDIATE 


AND Rj,N 
AND N,Rj 


Type 4 Instruction 


' ! ! t | ! 

; 1000 ; 0001 | RJ 4 0000 | N 24 

' ' t 1 ' ! ' BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(C(Rj)) are logically ANDed with UN. The result replaces 
C(C(Rj))- 
Operand Object Code (Hex) 
Types 2123456 
Rj,N 8Bijonn 
N,Rj 81ljoOnn - 
Example 
Label Opc Operand. Comment 
Field Field Field Field 
AND R3,X'B' 
AND X'C',RS5 
NOTE : Provided for compatibility. Preferred usage is 
AND WW. 
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AND WITH STORAGE 
AND Rj,Ri 


Type 3 Instruction 


! | I ! | 

' 1110 ! 0001 | Rj ! Ri! 16 

I 1 I 1 t BITS 
1 2 3 4 


Detailed Description of Instruction Execution 
C(C(Rj)) are logically ANDed with C(C(Ri)). 


The result replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types a. a 
Rj,Ri Elji 

Example 
Label oOpc Operand Comment 
Field Field Field Field 

AND R15,R14 
NOTE : Provided for compatibility. Preferred usage is 
AND WW. 
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AND ELEMENT WITH ELEMENT 
AND Wi,W3 


Type 6 Instruction 


] | | { | | 
F 1ll1 | 1011} Wir | wir | Wik } Wid | 
{ { { | 
em ee es 
i 5 3 4 5 7 7 9 
Wo foe op ee Oe ee eS ee ee 
( { | 
1 Wik SI Wid 48 
{ { 1 ( ( BITS 
ge ge ag go 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is logically ANDed with C(C(Wjr)+Wjd). The result 
replaces C(C(Wjr)+Wjd). 


Operand Wik Wijk Object Code (Hex) 
1 34 95 


Types 123456789012 
Ci,Cj 0 0 FBrrQdddoOddd 
Hi,Hj 0 0 FBrrQdddoOddd 
Ti,Tj 1 1 FBrridddlddd 
Di,Dj 2 2 FBrr2dddqd2ddd 
Fi,Fj 3 3 FBrr3ddqdaqa3dadd 
Si,Sj 3 3 FBrr3dddaq3dadd 
Vi,Vj 7 7 FBrri.dddT7tddd 

Example 

Label Opc Operand Comment 
Field Field Field Field 

AND HTYPI,HTYPJ 

AND CTYPI,HTYPJ 

AND TTYPI,TTYPJ 

AND DTYPI ,DTYPJ 

AND PTYPI,FTYPJ 

AND STYPI,STYPJ 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-6 


INSTRUCTIONS 


ATTACH REGISTER 


ATT Rj 


Type 3 Instruction 


oe ee a ee 


t 1 ! ! | 

; 0O11 ; 1101 ; RJR | 0000 | 16 

! { 1 \ ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


If Rj is detached, it is attached. 


Operand Object Code (Hex) 
Types 2 ok 
Rj 3D j0 
Example 
Label Opc Operand Comment 
Field Field Field Field 
ATT R12 ATTACH REG 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-7 


INSTRUCTIONS 


ATTACH REGISTER AND SET REGISTER 


ATT Ri,Rj 


Type 3 Instruction 


! ! ! ( I 

' 0011 ! 1110 ! Ri ! RZ ! 16 

! ] I [ ( BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction attaches Ri if it is detached. It then sets the 


C(Rj) to point in unlinked format to byte zero of the buffer that 
the C(Ri) addresses. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 3 Ei j 
Example 
Label Opc Operand Comment 
Field Field Field Field 
ATT R12,R14 POINT R14 AT R12'S BUFFER 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-8 


INSTRUCTIONS 


BRANCH TO LOCAL LOCATION 


Type 12 Instruction 
1 


! ! | ! 1 

, 0011 ; 0101 ; 0000 ,; L-1l : 24 

1 ' ! ! ] 1 ! BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


Control is transferred to the location in the current buffer 
defined by the iocal address of the label L. The local address is 
a byte displacement into the executing frame. 


Operand Object Code (Hex) 
Types 123456 
L 3 5.0: 1 2 
Example 
Label Opc Operand Comment 
Field Field Field Field 
B LOCLAB 


Programming Notes: For entry points into amode OSYM has the 
mnemonic instruction EP L, which assembles to the same object 
code as this instruction. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-9 


INSTRUCTIONS 


BRANCH ON BIT CONDITION (SET OR ZERO) 
BBc Bi,L 


Type 9 Instruction 


’ ! ! ' ( ’ t 
' 1011 ; 0101 | Bir {| 0000 |; Bik | Bid 
i | i | ! j | t J 
5 a ee, (ake ees ee, a eS a. eee eee eee eee ee eres: [2 
1 2 3 4 5 6 7 8 
aa A aaa 
| ’ | 
1 se ! L-1 ' 48 
( ( 1 { | BITS 
9 10 ll 12 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
Z BBZ 0010 ¢ (BIT) ZERO 
S BBS 0110 *% (BIT) SET 


dl 


C(C(Bir) + Bid) is tested for set (one) or zero. 


If the relation corresponds to the comparison code c, control 
transfers to L. 


Operand Wik Object Code (Hex) 


Types 1234567899012 
Bi,L b BS5S5iogbdddelll 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BBZ BTYPI , LOCLAB 
BBS BTYPJ,LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-10 


C 


INSTRUCTIONS 


BRANCH ON BIT CONDITION (SET OR ZERO) WITH RELATIVE OFFSET 
BBc Ri,Hj,L 


Type 9 Instruction 


48 
BITS 


Detailed Description of Instruction Execution 


The code C can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
Z BBZ 0010 (BIT) ZERO 
S BBS 0110 (BIT) SET 


C(C(Ri)+C(C(Hjr)+Hjd)) is tested for set (one) or zero. 


If the relation corresponds to the comparison code c, control 
transfers to L. 


Note: The bit offset, that is, C(C(Hjr)+Hjd)), must be zero or 
positive. 


Operand Wik Object Code (Hex) 


Types 123456789012 
Ri,H},L 0 D2jiododddci1lll 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BBZ R15,HTYPI,LOCLAB 
BBS R6,HTYPJ, LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-11 


INSTRUCTIONS 
BRANCH ON CHARACTER ALPHABETIC ) 


BCcA Ri,L 


Type 8 Instruction 


| | | ] ] { 

' 7000 | 1000 | Ri | 0000! c | L-1 | 39 

' } { q ] i { ] ] BITS 
Sea aa VaR a Ta, aa a 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
BCA 1000 ALPHABETIC 

N BCNA 1100 NON ALPHABETIC 


C(C(Ri)) is tested as to whether or not it is alphabetic by using 
a bit map in the PCB at location X '3E0'. 


If the relation corresponds to the comparison code c,_ the in- 


struction causes a branch to L. | 
Operand Object Code (Hex) 
Types 12345678 
Ri,L 88idelll 
Example 
Label Opec Operand Comment 
Field Field Field Field 
BCA R6 , LOCLAB 
BCNA R5 , LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-12 


INSTRUCTIONS 


C BRANCH ON RELATIVE CHARACTER COMPARE 


BCc Ci,Rj,L 


Type 9 Instruction 


{ \ i ' t { 
' 1101 |! 0111 ! Cir ! Rj} |} Cik! Cid | 
' ' 1 ' { I 
[ee eas er res) ee Ae ee eS ee 
1 2 3 4 5 6 7 8 
Mise eer eS ee nee eee wey 
' { 
Y L-1 48 
| | { \ I BITS 
9 10 1l 12 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
L BCL 1001 LESS THAN 
. E BCE 1010 EQUAL 
H BCH 1011 HIGHER THAN 
HE BCHE 1101 HIGHER THAN OR EQUAL 
U BCU 1110 UNEQUAL 
LE BCLE 1111 LESS THAN OR EQUAL 
C(C(Cir)+Cid) is compared logically with C(C(Rj)). 
If the relation corresponds to the comparison code c, the instruc- 
tion causes a branch to L to occur. 
Operand Cik Object Code (Hex) 
Types 123456789012 
Ci,Rj,L 0 D7ijododddclilil 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BCE CTYPI,R7,LLB 
C BCLE CTYPJ,R13,LOCB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-13 


INSTRUCTIONS 


BRANCH IMMEDIATE COMPARED TO CHARACTER 


BCc N,Ri, 


L 


Type 10 Instruction 
2 a a a a (a a 


f 1 ! | | ! 1 
; 1000 ; 0111 ; Rij; 0000 | N ; ec ; 
' ‘ I i ! | ! { 
ae ee 
1 2 3 4 5 6 7 
ee 
! \ 
I L-i 40 
I ! ' I BITS 
8 9 10 
Detailed Description of Instruction Execution 
The code c can take on the following values: 
Complete In the Compare 
Mnemonic Instruction Relation 
L BCL 1001 LESS THAN 
E BCE 1010 EQUAL 
H BCH 1011 HIGHER THAN 
HE BCHE 1101 HIGHER THAN OR EQUAL 
U BCU 1110 UNEQUAL 
LE BCLE 1111 LESS THAN OR EQUAL 


N 
branch to 
Cc. 


is compared logically with C(C(Ri)); 


L 


the instruction causes a 
if the relation corresponds to the comparison code 


Operand Object Code (Hex) 
Types T2345 6 789 0 
Ri,N,L 4AGidnnclilil 
37 
Example 
Label Operand Comment 
Field Field Field Field 
BCU C’'D',R14,LOCLAB 
BCLE C'J',R9,LOCABS 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 


INSTRUCTIONS 
(> BRANCH ON CHARACTER NUMERIC 


BCcCN Ri,L 


Type 8 Instruction 


{ ( j ] j | 

' 17000 | 1001 ' Ri | 0000! c | L-1 ry 

I | ! ! ! I | I { BITS 
a 3 4 5 G 7 —_—— 3 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
BCN 1001 NUMERIC 
N BCNN 1101 NON NUMERIC 
C(C(Ri)) is tested as to whether or not it is numeric, that is, 


ASCII 0 to 9. 


If the relation corresponds to the comparison code c, the 
instruction causes a branch to L. 


ed 
Operand Object Code (Hex) 
Types 12345678 
Ri,L 89idcl1ll1i1l 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BCN R6 , LOCLAB 
BCNN R5, LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 2€SEP88 2>i5 


INSTRUCTIONS 


BRANCH ON CHARACTER COMPARE 


BCc Ri,Rj,L 


Type 8 Instruction 


| { 1 { ] 1 

' 4210 ' 0111 | Ri | RJ! Cc L-1 | 39 

| ] | | | | ! ] I BITS 
Bg Re re ee Eg a, cea ae 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
L BCL 1001 LESS THAN 
E BCE 1010 EQUAL 
H BCH 1011 HIGHER THAN 
HE BCHE 1101 HIGHER THAN OR EQUAL ; 
U BCU 1110 UNEQUAL 
LE BCLE 1111 LESS THAN OR EQUAL 
C(C(Ri)) are compared logically with C(C(Rj)); the instruction 
causes a branch to L if the relation corresponds to the 
comparison code c. 
Operand Object Code pHex) 
Types 22345678 
Ri,Rj E7ijceclll 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BCE R14,R15,LOCLAB 
BCLE R7,R9,LOCABS 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-16 


INSTRUCTIONS 
BRANCH ON CHARACTER HEXADECIMAL 


BCcX Ri,L 


Type 8 Instruction 


l 

; 1000 ; 1010 ; Ri ; 0000; Cc haat | 32 

I BITS 
1 2 3 4 6 7 8 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
BCX 1001 HEXADECIMAL 

N BCNX 1101 NON HEXADECIMAL 


C(C(Ri)) is tested as to whether or not it is hexadecimal, that 
is, ASCII 0 to 9 or A to F. 


If the relation corresponds to the comparison code c,_ the 
instruction causes a branch to L. 


Operand Object Code (Hex) 
Types 12345678 
Ri,L BAiOcI1l1l 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BCX R6, LOCLAB 
BCNX R5 , LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-17 


INSTRUCTIONS 


BRANCH ON REGISTER TO REGISTER COMPARE J 
Bc Ri,Rj,L 


Type 8 Instruction 


{ ' I | | | { 

' 0101 ' 0100 | Ri |} RJ ! c ! L-1 399 

{ J ' ' ' | 1 I | BITS 
ag ag ge a Saas 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
E BE TA'010 EQUAL 
U BU ‘L110 UNEQUAL 


Ri and Rj are normalized and attached. The FID fields of the’ two 
registers are compared. If they are equal, the displacement fields 
are compared. The instruction causes a branch to L if the result 
of the compares corresponds to the comparison codec. C(Ri) and 
C(Rj) are not changed other than being normalized and attached. > 


Operand Object Code (Hex) 
Types 12345678 
Ri,Rj,L §4ijeclll 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-18 


INSTRUCTIONS 
( BRANCH ON ADDRESS REGISTER COMPARE 
Bo Si,Rj,L 


Bc Rj,Si,L 


Type 9 Instruction 


i ——— Ge ae ee ee ee eS = ae alls 


] ( ] 
' 1101 !' 0100 ! Sir Rj 
| { J 


Wn 
- 
An 
nN 
hb 
Q. 


1 2 3 4 5 6 7 8 
on ee ee Pn 
' t ! 
rue L-1 } 48 
i I | | | BITS 
9 10 11 12 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
E BE 71010 cr" EQUAL 
U BU -1110 * =»? UNEQUAL 


This instruction is always executed as Si compared to Rj. If the 
second form is used, the c field conditions are inverted. 


If Rj is attached, the detached form is calculated. If Rj is 
detached, the register is attached and then the detached form is 
calculated. 


In either case, the virtual storage address in Rj is normalized 
(displacement between 0 and 511 for unlinked frames and displace- 
ment between 0 and 500 for linked frames). 


After Rj is normalized, the displacement fields and the FID 
fields of the two operands are compared. If the relation 
corresponds to the comparison code c, the instruction causes a 
branch to L. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-19 


INSTRUCTIONS 


BRANCH ON ADDRESS REGISTER COMPARE (cont) 


Operand Wik Object Code (Hex) 


Types 123456789012 
Si,Rj,L 3 B4ij3dqddcl1lll 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
BE R14,STYPI,LOCLAB 
BU STYPJ,R5,LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-20 


INSTRUCTIONS 


BRANCH ON ZERO CONDITION 


Ss 


Bc Wi,L 
Type 9 Instruction 


CS ee 
{ ( ( 
; 1011 ; 0100 }; Wir 
t | 1 


© 
© 
© 
© 


1 2 3 4 5 6 7 8 
Teo ee 
{ i t 
i « L-1l 48 
’ ’ ] ’ ! BITS 
9 10 ll 12 
The code c can take on the following values: 
Complete In the Compare 
Mnemonic Instruction Relation 
LZ BLZ 0001 LESS THAN 
Z BZ 0010 EQUAL 
HZ BHZ 0011 HIGHER THAN 
HEZ BHEZ 0101 HIGHER THAN OR EQUAL 
NZ BNZ 0110 UNEQUAL 
LEZ BLEZ 0111 LESS THAN OR EQUAL 
C(C(Wir)+Wid) is compared arithmetically with zero; the 


instruction causes a branch to L 
the comparison code c. 


if the relation corresponds to 


C(ACF) is not changed. 


Operand Wik Object Code (Hex) 

Types _ 123456789012 
Hi,L 0 B4@€iododgdddcl1lill 
Ti,L 1 B4iodgoldddelll 
Di,L 2 B4iodg2dadqdcllil 
Fi,L 3 B4€iodg3z3daddceclll 
Vi,L 7 B4@€iodg7v?wdddclll 

Example 

Label Opc Operand Comment 
Field Field Field Field 
BNZ HTYPI,LOCLAB 
BLEZ FTYPI , LOCLAB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-21 


INSTRUCTIONS 


BRANCH ON ELEMENT COMPARE | ) 


Bc Wi,Wj,L 


Type 11 Instruction 


! ) ! ! | { 
' 1111 | 0100 | Wir! wir! Wik | wid ! 
t ! I ! ! I | ' ! 
a ee 
1 2 3 4 5 6 7 8 
eet ae lS ee a ee 
! ' ! ! ! 
| Wk | Wjd i ¢ L-1 64 
! ! ’ ' ' 1 ' ' ' BITS 
9 10 11 12 13 14 15 16 
Detailed Description of Instruction Execution 
The code c can take on the following values: 
Complete In the Compare 
Mnemonic Instruction Relation 
L BL 0001 LESS THAN 
E BE 0010 EQUAL 
H BH 0011 HIGHER THAN 
HE BHE 0101 HIGHER THAN OR EQUAL 
U BU 0110 UNEQUAL 
LE BLE 0111 LESS THAN OR EQUAL 


C(C(Wir)+Wid) is compared arithmetically with C(C(Wjr)+Wjd). 
If the relation corresponds to the comparison code c, the 
instruction causes a branch to L. 


Note: Storage registers (element type S) can only be used with 
mnemonics BE and BU. 


Operand Wik Wijk Object Code (Hex) 
12 3 5678 9 


i 
@ 
| 
| 
i 
| 
| 
| 
| 
| 
| 
Io 
[= 
jr 
uo 
| 
Jun 
In 


Hi,Hj,L 0 0 F4ijyOddd0dddelll 
Ti,Tj,L 1 1 F4ijyldddidddelll 
Di,Dj,L 2 2 F4ij2ddd2dddelll 
Fi,Fj,L 3 3 F4ij3ddd3dddcelll 
Si,Sj,L 3 3 F4ij3ddd3dddelll 
Vi,Vj,L 7 7 F4ij7zvddd7dddelll 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-22 


INSTRUCTIONS 


BRANCH ON STORAGE COMPARE (cont) 


Example 
Label Opc Operand Comment 
Field Field Field Field 
BE HTYPI,HSTYPJ,LLB 
BLE FTYPI,FTYPJ,LOCB 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 Z-23 


INSTRUCTIONS 


BASIC DECODE J 
BDCD 


Type 3 Instruction 


{ 1 i ' ' 

' 0100 } 1000 ; 0110 ; 0011 | 16 

I i § t ' BITS 
1 2 3 4 


Detailed Description oz: Instruction Execution 


This instruction assumes that R6 is pointing one byte before a 
compiler object code (COC) instruction. The instruction pointer 
R6 is incremented by one so that it points at the COC instruction 
operation code byte. The operation code may be followed by an 
operand. In any case, R6 will be incremented subsequently by the 
amount necessary to make it point one before the next COC 
instruction. 


The one-byte operation code of the COC instruction is read. If 
the code is implemented in microcode, the firmware uses the code 
as an index into the branch table to get the address of a 
software routine to execute the operation. The firmware branches . 
to that routine. If the code is implemented in microcode, th 
microcode branches to one of its own routines to execute it. 


Refer to the Basic Runtime System for the codes that are 
implemented in microcode. 


Operand Object Code (Hex) 
Types 1234 
48i j 
Example 
Label Opc Operand Comment 
Pield Field Field Field 
BDCD * 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-24 


INSTRUCTIONS 


( BRANCH DECREMENTING BY ONE COMPARE 


BDc Wj,L 


Type 9 Instruction 


eo we Se ee ee ee ee ee ee 


| \ J | | 
' 1011 ' 1100 | wjr ! 0000! w 
| | I | ( 


it 2 3 4 5 


Detailed Description of Instructi 


on Execution 


The code c can take on the following values: 


Complete In the 
Mnemonic Instruction 
LZ BDLZ 0001 
Z BDZ 0010 
HZ BDHZ 0011 
~ HEZ BDHEZ 0101 
NZ BDNZ 0110 
LEZ BDLEZ 0111 
One is subtracted from C(c(wWjr 
C(C(Wjr)+Wjd). Then C(C(Wjr)+Wjd) 


zero. 


If the relation corresponds to th 
tion causes a branch to L to occu 


C(ACF) is NOT changed. 


Compare 
Relation 


LESS THAN 

EQUAL 

HIGHER THAN 

HIGHER THAN OR EQUAL 
UNEQUAL 

LESS THAN OR EQUAL 


)+Wjd) and this result replaces 
is tested for its relation to 


e comparison code c, the instruc- 
r. 


Operand Wik Object Code (Hex) 
12 3 5678 9 


Types 2123456789012 
Hj,L 0 BCjJO00ddd 
Tj,L 1 BCjOlddd 
Dj,L 2 BC}02ddd 
Fj,L 3 BC}03ddd 
vj,L 7 BC}O7ddd 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU 
PRELIMINARY 20SEP88 2-25 


INSTRUCTIONS 


INSTRUCTIONS 


BRANCH DECREMENTING BY ONE COMPARE 


Label Opc 
Field Field 


Operand 
Field 


TTYPJ,LLB 
DTYPJ,LOCB 


(cont) 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 


PRELIMINARY 20SEP88 


INSTRUCTIONS 


C BRANCH DECREMENTING ON ELEMENT COMPARE 
BDc Wj,Wi,L 


Type 11 Instruction 


t { 
a Ne ee ee 
1 2 3 4 5 6 7 8 
SS SS, 
! t I 1 { 
1 Wik | Wid ae L-1 : 64 
’ ’ i | ] ’ ] ! I BITS 
9 10 ll 12 13 14 15 16 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
LZ BDLZ 0001 LESS THAN 
Z BDZ 0010 EQUAL 
HZ BDHZ 0011 HIGHER THAN 
HEZ BDHEZ 0101 HIGHER THAN OR EQUAL 
= NZ BDNZ 0110 UNEQUAL 
LEZ BDLEZ 0111 LESS THAN OR EQUAL 


C(C(Wir)+Wid) is subtracted from C(C(Wjr)+Wjd) and this result 
replaces C(C(Wjr)+Wjd). Then C(C(Wjr)+Wjd) is tested for its 
relation to zero. 


If the relation corresponds to the comparison code c, the instruc- 
tion causes a branch to L to occur. 


C(ACF) is NOT changed. 


Operand Wijk Wik Object Code (Hex) 
1234567 8 9 


Types 12345678990123456 
Hj,Hi,L 0 0 F2jid0dddOdddelll 
Tj,Ti,L 1 1 F2jildddidddclll 
Dj,Di,L 2 2 F2ji2ddd2dddc1ll1l 
Fj,Fi,L 3 3 F2ji3ddd3dddelll 
Vj,Vi,L 7 7 F2ji7ddd7dddcell1il 
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INSTRUCTIONS 


BRANCH DECREMENTING ON STORAGE COMPARE (cont) - 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BDZ TTYPJ,TSTYPI,LLB 
BDLEZ DTYPJ,DTYPI,LOCB 


Programming Note: If the first operand (Wj) is being decremented 
by one, use the BDc Wj,L instruction, which decrements by one 
implicitly. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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INSTRUCTIONS 


C BRANCH ON LOGICAL COMPARE 
BL.c Wi,Wj,L 


Type 11 Instruction 


I 1 
a i a ee he 
1 2 3 4 5 6 7 8 
a ee ee ee 9 ee 
fee A : 
1 Wyk \ Wid 1 Cc i L-1l 1 64 
! I ' ! J 1 | ! 1 BITS 
9 10 11 12 13 14 15 16 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
L BL.L 1001 LESS THAN 
E BL.E 1010 EQUAL 
H BL.H 1011 HIGHER THAN 
HE BL.HE 1101 HIGHER THAN OR EQUAL 
ad U BL.U 1110 UNEQUAL 
LE BL.LE 1111 LESS THAN OR EQUAL 
C(C(Wir)+Wid) is compared logically with C(C(Wjr)+Wjd). If the 
relationship matches the comparison code c, control transfers to 


L. 


C(ACF) is NOT changed. 


Operand Wik Wijk Object Code (Hex) 


Types 123435367890123456 
Ci,Cj,L 0 0 FlijOdddO0dddceclll 
Hi,Hj,L 0 0 FlijOdddO0dddelll 
Ti,TJ,L 1 1 Flijldddidddclll 
Di,Dj,L 2 2 Flij2ddd2dddel1ll 
Fi,Fj,L 3 3 Flij3ddd3dddcel1ll 
Vi,Vj,L 7 7 Flij7?ddd7dddceclil1l 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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INSTRUCTIONS 


BRANCH ON LOGICAL COMPARE (cont) 


Programming 
same object 


Opc Operand Comment 
Field Field Field 
BL.E TTYPI,TSTYPJ,LLB 

BL.L DTYPI,DTYPJ,LOCB 


Note: The mnemonic form BCc Ci,Cj,L results 


code as BL.c Ci,Cj,L. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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in the 


C 


INSTRUCTIONS 


BRANCH AND STACK INDIRECT TO A MODAL ENTRY 


BSLI 


Type 1 Instruction 


pte ee eee 

{ | 

' 0000 ! 0101 ! 8 

| | ' BITS 
I 2 


Detailed Description of Instruction Execution 


The address of the instruction following this instruction is 
pushed onto the return stack. 


C(TO) is assumed to be a mode-id with the entry point number 
(Me) in bits 0-3 and the FID (Mf) in bits 4-15. 


Control is transferred to frame Mf at location 1+(2*Me). 


When this instruction is executed, register one is updated to 
point to byte zero of the ABS frame being entered. 


Operand Object Code (Hex) 
Types ps 
05 
Example 
Label Opc Operand Comment 
Field Field Field Field 
BSLI 


Caution: This instruction generates a RETURN STACK FULL abort if 
RSCWA is incremented beyond the end of the stack. 
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INSTRUCTIONS 


BRANCH AND STACK TO LOCAL LOCATION - 


BSL L 


Type 12 Instruction 
<7 


! I J ' ' 

; 0011 ; 0001 ; 0000 | L-1l 24 

! | ! ! | ! ! BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


The address of the instruction following this instruction is 
pushed onto the return. stack. Control is transferred to the 
instruction at L. 


Operand Object Code (Hex) 
Types 123456 
L 3101141 
Example 
Label Opc Operand Comment 
Field Field Field ; Field 
BSL LOCLAB 


Caution: This instruction generates a RETURN STACK FULL abort if 
RSCWA is incremented beyond the end of the stack. 
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INSTRUCTIONS 


BRANCH AND STACK TO A MODAL ENTRY 


BSL M 
BSL N,M 
Type 12 Instruction = ee 
2 y Z 2 f ~ 
(a er, 
l ! ! ' 
: OO1L ; 0000 ; Me |; Mf 24 
! ! t ! | t t BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


The address of the instruction following this instruction is 
pushed onto the return stack. 


M is a mode-id made up of an entry point number (Me) and a FID 
(Mf). Control transfers to frame Mf at location 1+(2*Me). 


When this instruction is executed, register one is updated to 
point to byte zero of the ABS frame being entered. 


Operand Object Code (Hex) 
Types 123456 
M 30ef ff 
N,M 3 0nf£f ff 
Where e,n are entry point numbers and fff are 
the 3 nibbles (12 bits) of the FID (Mf). When N 
is given, n overrides e. 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
MTYPJ DEFM 12,128 
BSL MTYPJ 
BSL 6,MTYPJ 


Caution: This instruction generates a RETURN STACK FULL abort if 
RSCWA is incremented beyond the end of the stack. 
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INSTRUCTIONS : 


BRANCH ON STRING COMPARE 


BSTc Ri,Rj,N,L 


Type 10 Instruction 


I yl yl I 
! ' ( 

| 0100 } 1100 | Ri 
! 1 ! 


ye) 
WJ 
= 
‘@) 


2 3 4 5 6 7 
.: i. sf Se se 
1 { 
L-1 ! 40 
! ! § I BITS 
8 9 10 


Detailed Description of Instruction Execution 


The code c can take on the following values: 


Complete In the Compare 
Mnemonic Instruction Relation 
E BCE 1010 EQUAL 
U BCU 1110 UNEQUAL 


This instruction may be used to compare two strings. Each strinng 
must end with a delimiter. 


C(Ri) and C(Rj) are incremented by l. _ 
If C(C(Ri)) and C(C(Rj)) are equal and less than N_ (delimiter 
character), the instruction increments the registers and compares 
again. 


If the contents of both bytes are greater than or equal to N, the 
strings are considered equal and the instruction branches or not 
depending on the comparison code c. 


If the contents of both bytes are less than N but unequal to each 
other, the strings are considered unequal and the instruction 
branches or not depending on the comparison code c. 


Operand Object Code (Hex) 
Types 1234567890 
Ri,Rj,N,L 4cigjnnelll 
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INSTRUCTIONS 


BRANCH ON STRING EQUAL (cont) 


Example 
Label OpcC Operand Comment 
Field Field Field Field 


Programming Note: This instruction can be used in conjunction 
with the BRANCH CHARACTER LOW instruction to compare two strings: 


BSTE R14,R15,M,EQUAL 
BCL R14,R15,LOW 
B HIGH 


where M is a delimiter value that is defined 
elsewhere. EQUAL, LOW, and HIGH are local labels. 


The first instruction compares strings. If the delimiter is 
encountered, the strings are equal. 


The second instruction compares the two bytes that were found 
unequal by the first instruction. 
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INSTRUCTIONS 


COMPARE STRINGS a 
COMP Ri,Rj,L ~ 


Type 8 Instruction 


| | ! \ 1 ] 

' 9100 ! 1101 ' Ri ! Rj} ! 0000 | en ay 

! ] | { { { ! ! t BITS 
a 5 — =. 


Detailed Description of Instruction Execution 


This instruction compares two strings until it finds two unequal 
characters or until it finds a delimiter in one or both strings. 


Before instruction execution C(Ri) and C(Rj) must point one byte 
before their respective strings. C(Ri) and C(Rj) are each 
incremented by one. If C(C(Ri)) and C(C(Rj)) are equal and not 
delimiters, the registers are again incremented and the next 
characters compared. This process continues until the characters 
are unequal or until a delimiter is found in one or both strings. 


The instruction recognizes three classes of delimiters. The first 
class comprises all the values in the range X'FB'-X'FF'. Any of 
these values signal the end of the string. 


The next delimiter class is the value X'F9'. This delimiter tel]ls~wW 
the firmware two things: Numeric characters follow, anc they are 
being sorted in ascending sequence. 


The third class of delimiter is the value X'FA'. It tells the 
firmware that numeric characters follow but they are being sorted 
in descending sequence. 


If the corresponding characters from each string are both numeric 
delimiters (X'F9" or X'FA'), the instruction branches’ to 
location L. If only one of the characters is a numeric delimiter, 
the branch is not taken. The instruction does not convert the 
numeric characters following an X'F9' or X'FA' delimiter. Also, 
the instruction does not look at a character to see if it is 
numeric. The X'F9' or xX'FA' delimiter must be inserted in the 
string by the software before the COMP instruction is executed. 


When the branch is taken, the software knows that both delimiters 
are numeric. Otherwise, the instruction does not inform the 
software that a numeric delimiter was encountered . 


When the branch is taken, the ACF is not changed. When the 
instruction falls through, ACF OVFBIT is zeroed, NUMBIT is 
undefined, and EQUBIT and LOWBIT are set as summarized in Figure 


A. i ) 
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INSTRUCTIONS 


COMPARE STRINGS (cont) 


If AND Then it means that 
String 1 String 2 


C(C(Ri)) C(C(RJ)) 


and it sets 
EQUBIT LOWBIT 


is is 

F9-FA F9-FA Both are numerics. N/C 
Branch is taken. 

FB-FF FB-FF String 1 = String 2 0 

<F9 and <F9 String 1 > String 2 0 

2C(C(Rj)) 

<F9 and <F9 String 1 < String 2 1 

<C(C(Rj)) 

F9-FA FB-FF String 1 > String 2 0 
String 1 is longer. 

FB-FF F9-FA String 1 < String 2 1 
String 2 is longer. 

FB-FF <F9 String 1 < String 2 1 
String 2 is longer. 

<F9 FB-FF String 1 > String 2 0 
String 1 is longer. 

F9 <30 String 1 > String 2 0 
Numeric 1S greater, ascending. 

F9 <F9 and String 1 < String 2 0 1 

>=30 Numeric is less, ascending. 

FA <DO String 1 > String 2 0 0 
Numeric is greater, descending. 

FA <F9 and String 1 < String 2 ) 1 

>=D0 Numeric is less, descending. 

<30 F9 String 1 < String 2 0 1 
Numeric is greater, ascending 

<F9 and F9 String 1 > String 2 0 0 

>=30 Numeric is less, ascending 

<DO FA String 1 < String 2 0 1 
Numeric is greater, descending 

<F9 and FA String 1 > String 2 0 0 


>=D0 Numeric is less, descending 
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INSTRUCTIONS 


Figure A. Summary of COMP Instruction Results 
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C 


INSTRUCTIONS 


COMPARE STRINGS (cont) 


Operand Object Code (Hex) 
Types 12345678 
Ri,Rj,L 4dDijolldl 
Example 
Label Opc Operand Comment 
Field Field Field Field 
COMP R14,R15,NUMST COMPARE STRINGS 
BBS EQUBIT,EQST BRANCH IF EQUAL 
BBS LOWBIT, LEST BRANCH IF STRING 1 LESS 


Programming Note: This instruction was designed to speed up _ the 
ENGLISH SORT verb. For an ascending, left-justified sort, the 
verb software puts an X'FF' after each string but does not change 
it otherwise. Specifically, the X'F9° delimiter is not used. For 
an ascending, right-justified sort, the software puts X'F9' 
before each string of numeric characters. When this delimiter is 
found in both strings, the software converts the numerics’ to 
binary and sorts then by value. At this writing, the SORT verb 
does not use the X'FA' delimiter. 


For a descending sort the software uses the two's complement of 
each character value for the sort. Since the software does not 
use the X'FA' delimiter, a descending, right-justified sort of 
numerics is not the reverse of an ascending, right-justified 
sort. 
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INSTRUCTIONS 
DISABLE BASIC DEBUGGER ) 


DBDB 


Type 1 Instruction 


Ae et ee 

] j 

; 0010 ; 0110 ; 8 

I BITS 
1 2 


Detailed Description of Instruction Execution 
This instruction resets the bits set by EBDB to disable traps to 
the Basic Debugger when the BDCD instruction encounters one of 
the following compiler object code instrucions: 

01 EOL 


06 BRANCH 


Operand Object Code (Hex) 
Types 12 
2 6 
ww 

Example 

Label Opc Operand — Comment 

Field Field Field Field 

DBDB DISABLE D/B DEBUGGER TRAPS 


Programming Note: This instruction along with EBDB replaces 
the use of bit DFLG to indicate a trap to the Basic Debugger. 
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INSTRUCTIONS 


DECODE 


DCDRR Ri,Rj 
DCD (The assembler's OSYM uses R6 for Ri and R3 for Rj) 


Type 3 Instruction 


oo ee a re ay 


I ! t | ! 

' 0100 ' 0011 ! Ri ! Rj} ! 16 

] ] | { ' BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction assumes that Ri is pointing one byte before a 
compiler object code (COC) instruction. The instruction pointer 
Ri is incremented by one so that it points at the COC instruction 
operation code byte. The operation code may be followed by an 
operand. In any case, Ri will be incremented subsequently by the 
amount necessary to make it point one before the next COC 
instruction. 


The one-byte operation code of the COC instruction is read. The 
firmware uses the code as an index into the branch table to get 
the address of a software routine to execute the operation. The 
firmware branches to that routine. The table address is in double 
tally DCDFID in the PCB. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 43ij 
Example 
Label Opc Operand Comment 
Field Field Field Field 
DCD 
DCDR R12,R15 
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INSTRUCTIONS 


DECREMENT ADDRESS REGISTER BY ONE 
J 
DEC R3 


Type 3 Instruction 


oe ae 

( l { 

1 9000 ; 0110 ; Rj 16 
{ 1 ! 


l I BITS 
1 2 3 4 


© 
© 
en) 
© 


Detailed Description of Instruction Execution 


If Rj is attached, C(Rj) is decremented by one. If Rj is 
detached, the displacement field of Rj is decremented by one; 
then the register is attached. 


Operand Object Code (Hex) 
Types 1234 
Rj 06j 0 
Example 
Label oOpc Operand Comment 
Field Field Field Field 


DEC R14 


In the linked format, if the resulting memory address is XY17 (XY 
represents any even hexadecimal number), that is, if the address 
points to byte 23 of a buffer: 


1. If the backward link of the current frame is zero, C(R) 
remains attached to data byte zero of the current frame; 


2. Otherwise, an attempt is made to attach C(R) to the last 
data byte of the frame pointed to by the backward link of 
the current frame. The "REFERENCING ILLEGAL FRAME" debug 
trap could occur in this case. 


3. If C(R}) is decremented again so that the resulting memory 
address is xXY16, a “BACKWARD LINK ZERO” debug trap will 
occur. 


Programming Note: Rj is always attached when this instruction 
completes execution. 
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INSTRUCTIONS 


DECREMENT ADDRESS REGISTER 
DEC Rj,Wi 


Type 5 Instruction 


| ] \ { ! ( { 

' 1011 | 0110 | wir! Rj | wik! Wid i 32 

I ! 1 ! I ! ( ! t BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


If Rj is attached, the memory address field of Rj is decremented 
by C(C(Wir)+Wid). If the resulting address crosses the frame 
boundary, the register is detached. If Rj is initially detached, 
the displacement portion of Rj is decremented by C(C(Wir)+Wid). 


Operand Wik Object Code (Hex) 
Types 12343678 
Rj,Hi 1 B6ijododdd 
Rj,Ti 1 B6ijlddd 
Rj,Di 1 B6ije2zeddd 
Rj,Fi 1 B6ij3dadd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
DEC R14,TTYPJ 
Programming Note: This instruction may cause an attached 


register to detach. It will never cause a detached register to 
attach. 
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INSTRUCTIONS 


{ 
SUBTRACT ONE FROM ELEMENT ) 
DEC Wj 


Type 5 Instruction 


( ! ! ! I | 

' 1010 ! 0110 ! Wir ! 0000 |! Wyk | wid 356 

] ] ' ! ! 1 t ! | BITS 
l 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
C(C(Wjr)+Wjd) is decreased by one. 


C(ACF) is NOT changed. 


Operand Wjik Object Code (Hex) 
1234567 8 


Types it 23 4360/78 
Hj 0 A6rQ0dQddd 
Tj 1 A6rQldadd 
Dj 2 A6rQ0Q2ddd 
Fy 3 A6r0O3dadd ; 
Vj 7 A6rOQO7daqdd 2 
Example 
Label OpCc Operand _ Comment 
Field Field Field Field 
DEC DTYPJ DECREMENT DTYPJ BY 1 
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C 


INSTRUCTIONS 


DEC Wj,Wi 


Type 6 Instructio 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is subtracted 


n 


SUBTRACT ELEMENT FROM ELEMENT 


replaces C(C(Wjr)+Wjd). 


C(ACF) is NOT changed. 


Operand Wijk Wik 


Hj,Hi 0 0 
Tj,Ti 1 1 
Dj,Di 2 2 
Fj,Fi 3 3 
Vj,Vi 7 7 
Example 
Label Opc 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 


PRELIMINARY 20SEP88 


Object Code (Hex) 
1 4567 8 


HTYPJ,HTYPI 
STYPJ,STYPI 


Comment 
Field 


from C(C(Wjr)+Wjd). 


The difference 


INSTRUCTIONS 


DIVIDE 


DIV Wi 


Type 5 Instruction 


( ! | { ] { 

' 1010 ! 1001 ! Wir ! 0000 ! Wik |! wid i 32 

! { t ( t ] ’ ] ! BITS 
ge gg oe 


Detailed Description of Instruction Execution 


C(DO0) is divided by C(C(Wir)+Wid). A 4-byte quotient replaces 
C(DO0); a 4-byte remainder replaces C(Dl). 


The sign of the quotient is determined by the rules of algebra. 
The sign of the remainder is the sign of the dividend. 


C(ACF) is changed: OVFBIT is set only when a divide by zero is 
attempted. It is not set for any other overflow condition. 


Operand Wik Object Code (Hex) 
Types ——— 22345678 
Hi 0 AQ idodadgddd 
Ti 1 A9i0lddd ww 
Di 2 AXQiodO2ddd 
Vi 7 AQ iodog?gv?v?eddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
DIV TTYPJ DO/TTYPJ 
DIV FTYPI FPO/FTYPI 


Programming Note: Data can be moved out of FPY using a Move 
Storage to Storage instruction. 


Programming Note: The mnemonic DIV may be used with F_ type 


operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction DIVX. 


o 
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INSTRUCTIONS 


DIVIDE EXTENDED 
DIVX Wi 


Type 5 Instruction 


Mg et ee a ees eer es pee er ee a ee YO ae g ten fe ms 


( I ’ 1 I ! | 

' 1010 | 1000 ; Wir ; 0000 | Wik |} Wid ; 32 

' I t ' { ' t ' \ BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(FPO) is divided by C(C(Wir)+Wid). A 6-byte quotient replaces 
C(FPO); a 6-byte remainder replaces C(FPY). 


The sign of the quotient is determined by the rules of algebra. 
The sign of the remainder is the sign of the dividend. 


C(ACF) is changed: OVFBIT is set only when a divide by zero is 
attempted. It is not set for any other overflow condition. 


Operand Wik Object Code (Hex) 
12 3 5 67 8 


Types 123436178 
Hi 0 A8Bidodddd 
Ti 1 A8Bidliddd 
Di 2 ABid2z2ddd 
Fi 3 A8BidOQg3ddd 
Vi 7 A8iodOdwvdddd 


Programming Note: Data can be moved out of FPY by using a Move 
Storage to Storage instruction. 
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INSTRUCTIONS 


f % 
DIVIDE DOUBLE-EXTENDED J 


DIVXX Fi 


Type 5 Instruction 


aaa aa am (a aa a 
! { t { ) 
| 1010 ; 1100 |; Fir ; 0000 ; Fik 
t ! { 1 { 


try 
-- 
OQ. 
we) 
N 


1 2 3 4 5 6 7 8 
Detailed Description of Instruction Execution 


This instruction divides a ten-byte binary number by 
C(C(Fir)+Fid). The most significant four bytes of the number must 
be in the four low-order bytes of FPY; the least significant six 
bytes must be in FPO. After the division the quotient is placed 
in FPO and the remainder in FPY. 


The sign of the quotient is determined by the rules of algebra. 
The sign of the remainder is the sign of the dividend. 


C(ACF) is changed: OVFBIT is set only when a divide by zero is 
attempted. It is not set for any other overflow condition. 


Operand Fik Object Code (Hex) 


Types 12345678 
Fi 3 ACiOdO3ddd 
Example 
Label Opc Operand . Comment 
Field Field Field Field 


DIVXX FTYPJ 
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C 


INSTRUCTIONS 


DEQUEUE I/O REQUEST 
DQIO Rj,N 


Type 4 Instruction 


! 1 ! ! | ( 

' OlOL | 1111 | Rj | 0000 | N 224 pe ae 
{ i | ' ! ! 1 ( BITS ce, a. t 

aor rE 3 4 5 6 oF! 


Detailed Description of Instruction Execution 

This instruction retrieves a completed task descriptor (TD) from 
its Completions Queue, returning the virtual storage address of 
the TD in Rj. 


Nis an eight-bit literal defining the dequeue criteria as 
follows: 


Bit Meaning 
0-3 Undefined; 
4 0 = Don't wait if request is not satisfied (No-Wait 
option); 
1 = Wait for completion (Wait option); 


5-6 Undefined; 


7 0 
1 


Dequeue first TD on queue (Dequeue option); 
Search queue for matching Stream number (Stream 
option). 


No-Wait Option 
When executed with the No-Wait option, the instruction always 
completes immediately with the status code in HO indicating 


whether or not a TD was actually dequeued as follows: 


Code Meaning 


(Hex) 

00 TD successfully dequeued; 

01 Completions Queue empty; 

ll No TD on queue with requested Stream number. 
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INSTRUCTIONS 


DEQUEUE I/O REQUEST (cont) 


Wait Option 


With the Wait option this instruction completes immediately if 
there is a suitable TD on the Completions Queue. If there is no 
suitable TD on the queue, the instruction roadblocks the process 
by setting the IOWAIT/ roadblock (removing the process from the 
Priority Queue) until a completed TD is queued onto the process's 
Completions Queue. The effect of this will be that the process 
will be re-activated executing the same DQIO instruction. 


A process can be roadblocked indefinitely if the instruction is 
executed with the Wait option in the following situations: 


N specifies the Dequeue option, but the queue is empty and 
there are no outstanding TDs; 


N specifies the Search option, but there are no TDs with the 
specified Stream number in the queue or outstanding. 


Dequeue Option 


The Dequeue option dequeues the first TD on the Completions 
Queue. 


Stream Option 


When the Stream option is specified, the Stream number to. search 
for must be specified in HO. 


Operand Object Code (Hex) 
Types 123456 
Rj,N 5FjOnn 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
DQIO R3,X'0' GET NEXT TD 
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INSTRUCTIONS 


ENABLE BASIC DEBUGGER 


EBDB 


Type 1 Instruction 


oe ee 

] 

; 0010 ; 0101 |; 8 

BITS 
1 2 


Detailed Description of Instruction Execution 
This instruction sets a bit in the PIB and a hardware bit 
directly testable by microcode to cause a trap to the Basic 
Debugger when the BDCD instruction encounters one of the 
following compiler object code instrucions: 

01 EOL 


06 BRANCH 


Operand Object Code (Hex) 
Types 12 
2 5 
Example 
Label Opc Operand Comment 
Field Field Field Field 
EBDB ENABLE D/B DEBUGGER TRAPS 


Programming Note: This instruction along with DBDB replaces 
the use of bit DFLG to indicate a trap to the Basic Debugger. 
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INSTRUCTIONS 


EXTERNAL BRANCH INDIRECT TO A MODAL ENTRY 


ENTI 


Type 1 Instruction 


| a ai eae 

t { 

' 9000 ! 0100! 8 

| ! ' BITS 
I 2 


Detailed Description of Instruction Execution 


C(T0) is assumed to be a Mode-ID with the entry point number (Me) 
in bits 0-3 and the FID (Mf) in bits 4-15. 


Control is transferred to the specified frame (Mf) at location 
1+(2*Me). 


Operand Object Code (Hex) 
Types 12 
0 4 
Example = 
Label Opc Operand Comment 
Field Field Field Field 
ENTI 
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C 


INSTRUCTIONS 


EXTERNAL BRANCH TO A MODAL ENTRY 


ENT M 


Type 12 Instruction 


I | ! I ( 

; 0011 ; 0100 | Me 13 Mf 24 

I \ ! I i | | BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


Control is transferred to the mode with FID Mf at location 
1+(2*Me). 


Operand Object Code (Hex) 
Types 123456 
M 34ef ff 


Where e is the entry point number and fff are 
the 3 nibbles (12 bits) of the FID (Mf). 


Example 
Label Opc Operand Comment 
Field Field Field Field 
MTYPJ DEFM 12,128 


ENT MTYPJ 


Programming Note: The assembler also recognizes the mnemonic 
format 


ENT N,M l1onffte 


where N overrides the Me for M. The opcode and Mf are the same, 
however. Execution of the object code instruction is also the 
same. 
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INSTRUCTIONS 


HALT 
HALT 


Type 1 Instruction 


oe Se 

| | ' 

' 0000 ! 1000 | 8 

! ! ' BITS 
1 2 


Detailed Description of Instruction Execution 
This instruction causes a trap to a debugger. 


The instruction traps to the Software Debugger, which displays 
the message “HALT INSTRUCTION." 


Operand Object Code (Hex) 
Types a2 
0 8 
Example 
Label Opc Operand Comment 
Field Field Field Field 
HALT 
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INSTRUCTIONS 


INCREMENT ADDRESS REGISTER BY ONE 
INC Rj 


Type 3 Instruction 


i ee eee eee Ne ho eet, eee 


I ! ' | | 

' 9000 ' 0111 | Rj} ! 0000! 16 

| ' ' | ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


If Rj is attached, C(Rj}) is incremented by one. If Rj is 
detached, the displacement field of Rj is incremented by one; 
then the register is attached. 


Operand Object Code (Hex) 
Types ee 
Rj 0734 0 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
INC R15 
Caution: If the resulting memory address is not in the same 


buffer, then either: 


1. A “CROSSING FRAME LIMIT" debug trap occurs if C(Rj) is in 
unlinked format; or 


2. An attempt is made to attach C(Rj) to the first data byte 
of the frame pointed to by the forward link of the 


current frame. In this case, “FORWARD LINK ZERO" and 
"REFERENCING ILLEGAL FRAME" are debug traps that could 
occur. 

Programming Note: Rj is always attached when this instruction 


completes execution. 
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INSTRUCTIONS 


INCREMENT ADDRESS REGISTER 


INC Rj, Wi 


Type 5 Instruction 


\ i { ! ! ' ! 

1 1011 ; O111 | Wir ; Rj | Wik | Wid 32 

| { 1 ! ' ! t 1 I BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


If R is attached, the memory address field of Rj is incremented 
by C(C(Wir)+Wid). If the resulting address crosses the frame 
boundary, the register is detached. If Rj is initially detached, 
the displacement portion of Rj is incremented by C(C(Wir)+Wid). 


Operand Wik Object Code (Hex) 


Types 12343678 
Rj,Hi 1 B7ijoOddd 
Rj,Ti 1 B7ijilddd 
Rj,Di 1 B7ij2zaddd 
Rj,Fi 1 B7ij3dqdd 
wl? 
Example 
Label Opc Operand _— Comment 
Field Field Field Field 
INC R13,TTYPI 
Programming Note: This instruction may cause an attached 


register to detach. It will never cause a detached register to 
attach. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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‘= 


INSTRUCTIONS 


ADD ONE TO ELEMENT 
INC W3 


Type 5 Instruction 


1 2 3 4 a) 6 7 
Detailed Description of Instruction Execution 


C(C(Wjr)+Wjd) is increased by one. 


Operand Wik Object Code (Hex) 
234567 8 


Types 1234567 8 
Hj 0 A7j,)0 O0ddd 
Tj 1 A7j)0 lddd 
Dj 2 A7j02ddd 
Fj 3 A7j,303dqdd 
Vi 7 A7j,30 7d4dd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
INC DTYPJ BUMP DTYPJ BY 1 
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INSTRUCTIONS 


ADD ELEMENT TO ELEMENT 
INC Wj,Wi 


Type 6 Instruction 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is added to C(C(Wjr)+Wjd). 


C(C(Wjr)+wWjd). 


(Hex) 
7 8 9 


© 
_— 
NO 


t 
Wid 48 
{ 
11 12 
The sum replaces 


Operand Wik Wi Object Code 
Types 12345 6 
Hj,Hi 0 0 F7jiodd 
tg ir! ba 1 1 F7jidlid 
Dj,Di 2 2 F7ji2d 
Fj,Fi 3 3 F7ji3d 
Sj,Si 3 3 F7ji3d 
Vj,Vi 7 7 F7jid7dd 
Example 
Label OpCc Operand 
Field Field Field 
INC HTYPJ,HTYPI 
INC STYPJ,STYPI 


oAOoaanana 


oO02000c080 


ot ol ommonmenes 
oOo0eadaana 
oo0e0aeaa0 
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PRELIMINARY 20SEP88 2-58 


INSTRUCTIONS 


LOAD ADDRESS DIFFERENCE 


LAD Si,Rj 
LAD Rj,Si 


Type 5 Instruction 


{ ! t ' ! ! I 

' 1011 |! 1110 |! Sir ! Rj} ! Sik | Sid E95 

I ! t ! ! ( | i 1 BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


This instruction subtracts C(C(Sir)+Sid) from C(Rj), and the 


difference replaces C(TO). The subtraction is done in the 
following manner. The detached form of C(Rj) is calculated. The 
C(C(Sir)+Sid) is treated as a storage address (2 bytes of 


displacement, 1 link byte, 3-byte FID). For unlinked frames both 
operands must reference the same FID: The difference between the 
displacements is the result in this case. The instruction is 
valid for unequal frame numbers only if both frames are in the 
same group of contiguously linked frames, and the difference 
between the FIDs is equal to or less than 32. For contiguously 
linked frames the result is calculated by multiplying the 
difference between the FIDs by 1000 and adding to that product 
the difference between the displacements. 


Operand Wik Object Code (Hex) 
Types 123453678 
Si,Rj 3 BEij3ddeo 
Rj,Si 3 BEij3dadd 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
LAD STYPJ,R14 
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INSTRUCTIONS 


LOAD ABSOLUTE | 
LOADA A 


Type 13a Instruction 


! 

( ! | \ 

| 0011 } 1111 | Ak | A I 39 
| 


{ I I { BITS 
os a oe ee es en ee, eee! eer 2 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
C(A) replaces C(DQ) for al, 2 or 4-byte operand. 


For a 6-byte operand, C(FPO) is replaced by C(A). 


Operand Aik Object Code (Hex) 
7 8 


Types 2123453678 
Hi 0 3FO0Oaaaaa 
Ti 1 3Flaaaaa 
Di 2 3F2aaaaa 
Fi 3 3F3aaaaa 
Example wo” 
Label Opc Operand Comment 
Field Field Field . Field 
LOADA @ALOC LOAD FROM ABSOLUTE 
Caution: Remember that a 6-byte operand affects the 6-byte 


accumulator FPQ. Shorter operands affect only DO, the 4-byte 
accumulator. 


Notes Only items defined in PSYM as '@' types can be used as 
operands. 
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INSTRUCTIONS 


LOAD ACCUMULATOR 
LOAD Wi 


Type 5 Instruction 


T ] T T | I I 
1 | | | { 
' 1010 |! 1111 !' Wir ! 0000 wid 1 32 
1 } { { i 


> > 
p~- 
na 


1 2 3 4 5 6 7 8 
Detailed Description of Instruction Execution 
The integer addressed by the operand is loaded into the 32-bit 


accumulator (DQ). That is, C(C(Wir)+Wid) replaces C(D0O). For 
half tally and tally operands, the sign bit is extended. 


Operand Wik Object Code (Hex) 


Types 12345678 
Hi 0 AFiodogddd 
Ti 1 AFiodlddd 
Di 2 AFiog2ddd 
Vi 7 AFiod7?eddd 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
TTYPJ DEFT 14,8 TALLY TYPE J 
LOAD TTYPJ LOAD DO 


Programming Note: The mnemonic LOAD may be used with F_ type 
operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction 
LOADX. 
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INSTRUCTIONS 


LOAD EXTENDED ACCUMULATOR 
LOADX Wi 


Type 5 Instruction 


{ | | 1 { { 

' 1010 ! 1110 |! Wir ! 0000 ! wik ! Wid i 30 

{ J { ] t ' ] { t B if 4 S 
Sica I  -y -,Cea 


Detailed Description of Instruction Execution 
The integer addressed by the operand is loaded into the 48-bit 


accumulator (FPO), and the sign bit is extended. That is, 
C(C(Wir)+Wid) replaces C(FP0O). 


Operand Wik Object Code (Hex) 
7 


Types 12345678 
Hi 0 AEiOogddd 
Ti 1 AEiodlddd 
Di 2 AEiQO2ddd 
Fi 3 AEio3j3ddd 
Vi 7 AEio?7vddd 
Example 
Label Opc Operand — Comment 
Field Field Field Field 
HTYPI DEFH 15 HALF TALLY TYPE I 
LOADX HTYPI MOVE VALUE TO FPO 
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INSTRUCTIONS 


LOCK PROCESSESSAND INCREMENT INHIBITH 


LOCKINH N 


Type 2 Instruction 
qo ee a 


I I 1 t 

, 0001 ; OO11 | N 16 

{ | | 1 ] BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction performs the same actions as the LOCK N 
instruction with the addition that if the lock is_ locked 
successfully, INHIBITH is incremented by one. 


Operand Object Code (Hex) 
Types 234°” 
N l13nn 
Example 
Label OpCc Operand Comment 
Field Field Field Field 


LOCKINH OVRFLW* 
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INSTRUCTIONS 


LOCK COMPETING PROCESSES FOR SYSTEM RESOURCE 


LOCK N 


Type 2 Instruction 


roe oe ee hg ee ae ee a 


t J ! ! 

' 0001 ; 0010 | N 16 

! ' i t t BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction enables processes to compete for a system 
resource by means of a lock. The first process to set the lock 
may use the resource. Other processes that attempt to set the 
lock will be roadblocked until the first process opens the lock 
with the UNLOCK N- instruction. UNLOCK N removes the _ roadblock 
from the first process in the priority queue that iS waiting on 
the lock. 


N is the lock number. 
There are three conditions handled by this instruction. 


If lock N contains the unlocked value, the firmware stores th , 
executing process's number in lock N, and instruction exccurion™ 
ends: The process has control of the resource. 


If lock N already contains the process number of the executing 
process, instruction execution ends: The process retains control 
of the resource. 


If lock N contains the process number of another process, the 
instruction deposits the value N in the executing process's PIB 
and enters the Monitor. The process is roadblocked until the lock 
is opened by the UNLOCK N instruction. 


Operand Object Code (Hex) 
Types 1234 
N l1l2nn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
LOCK OVRFLW* 
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INSTRUCTIONS 
LOCK COMPETING PROCESSES (cont) 


Programming Note: This instruction does not know the resources 
that are being locked. The correlation of a lock with a resource 
is a software convention. In fact there is nothing in the system 
to prevent a process from using a resource without using this 
instruction. 


If more than one lock must be locked at one time, there _ should 
also be a_ software convention that specifies the order in which 
the locks should be locked. This avoids the problem of two 
processes roadblocking each other by locking two locks in 
different order. 
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INSTRUCTIONS 


LOCK COMPETING PROCESS FOR SOFTWARE RESOURCE S, 
LOCK Tj 


Type 5 Instruction 


Wee SP re a Fa et ee ee gy Se oe Ye tees eee ee ee ee ete ee 


| I | ! ] ! 

' 1011 | 1000 |! Tir | 0000 ! Tk | Tid 32 

| ! 1 ] ( | i) ! I BITS 
sa CR a a aT a a aaa a 


Detailed Description of Instruction Execution 

This instruction enables processes to compete for a software 
resource by means of a lock. The first process to close the lock 
may use the resource; other processes that attempt to set the 
lock are deactivated. 


The instruction sets C(C(Tjr)+Tjd) with a value that indicates 
that the lock is closed. 


You unlock the lock by means of the SET instruction, that is, 


SET Tj 


Operand Tjk Object Code (Hex) 


Types 123453678 
Tj 1 AASjOlddd 
a 
be 
Example 
Label OpCc Operand Comment 
Field Field Field Field 
LOCK TTYPJ LOCK A SOFTWARE RESOURCE 
SET TTYPJ UNLOCK IT 
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INSTRUCTIONS 


LOAD PIB ADDRESS TO REGISTER 
LPIB Rj 


Type 3 Instruction 


| \ | I J 

' 0011 ! 1010 ! Rj ! 0000! 16 

I 1 ' 1 1 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction assumes that C(T0) is a process number. The 
instruction replaces C(Rj) with that process's PIB address. The 
instruction also returns the PIB software flag byte in Hl and one 
of the following codes in HO: 


Code Meaning 


0 Successful 

1 No PIB pointer 

2 Invalid process number 
3 No FID allocated to PIB 


Operand Object Code (Hex) 
Types 1234 
Rj 3 Ajo 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
LPIB R15 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-67 


INSTRUCTIONS 


MOVE BINARY TO DECIMAL | 
MBD Ti,R} ~ 


Type 5 Instruction 


{ I 1 ! 1 ! ] 

1 1101 ; 1011 ; Tir | Rj | Tik | Tid 32 

I i ' ! ( ! ' | { BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


This instruction assumes that the low-order byte of C(C(Tir)+Tid) 
contains a binary number with a value in the range 0 to 9. The 
instruction converts the binary number to an ASCII character, 
which replaces the C(C(Rj)). C(C(Tir)+Tid) is not changed. 


Operand Tik Object Code (Hex) 


Types 12345678 
Ti,Rj 1 DBijtlddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MBD TTYPI,R14 
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INSTRUCTIONS 


MOVE BINARY TO HEXADECIMAL STRING 
MBX Wi,Rj 


Type 5 Instruction 


1 T { ] ( T ! 
) ! ! I ! | l 
' 1011 ! 1111 ! Wir ! Rj ! Wik | Wid 1 32 
| ' I 1 1 ( 1 


eee eee ee ee. | 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


The binary integer which is C(C(Wir)+Wid) is converted into an 
ASCII string of hexadecimal numbers starting at C(Rj)+l. Bits 4-7 
of HO (the low-order byte of DO) contain a count of the maximum 
number of ASCII bytes to be generated. If bit zero of HO isa 
zero, the leading zeros of the hexadecimal string are suppressed; 
that is, they are not moved to the output string. if bit zero of 


HO is a one, zero suppression will not take place. C(Rj) is 
incremented before each hexadecimal character is stored. C(H0) is 
unpredictable after this instruction is executed. If the digit 


count in HO exceeds the size allowed, no operation is performed. 


The maximum digit count is twice the size of the first operand: 
12 for S, 8 for D, 4 for T, etc. A count of zero is not allowed. 


Operand Wik Object Code (Hex) 
1 2 3 5 


Types 12345678 
Ci,Rj 0 BFijoOddd 
Hi,Rj 0 BFijOdd-d 
Ti,Rj 1 BFijlddd 
Di,Rj 2 BFij2ddd 
Fi,Rj 3 BFij3dadd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
=H6 HTLY 6 
MOV =H6 ,HO 
MBX FTYPI,R15 


Programming Note: At the conclusion of instruction execution Rj 
points to the last character converted. 
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INSTRUCTIONS 


MOVE RELATIVE CHARACTER TO CHARACTER 


MCC Ci,R} 


Type 5 Instruction 
I ! ! ! ! ! 
; 1101 ; 0110 ; Cir ; Rj ; Cik | 
I I ’ ( ( ! 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(C(Cir)+Cid) replaces C(C(Rj)). 


Operand Cik Object Code (Hex) 


Types 12345678 
Ci,Rj 0 D6igjgQ0ddd 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
MCC CTYPI,R15_ 
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INSTRUCTIONS 


MOVE IMMEDIATE CHARACTER 


MCC N,Rj 


Type 4 Instruction 


T { T T T J 
| | I | \ | 
' 0101 | 0110 | Rj ! 0000! N 1 24 
! 1 1 | | 1 


BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


N replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types 1234356 
N,Rj 56j0Onn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MCC 6,R13 
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INSTRUCTIONS 


MOVE CHARACTER TO RELATIVE CHARACTER 


Type 5 Instruction 


] | | ' ] ' 
| 1100 | 0110 | Cir | Ri | Chk | Cjd 
i ] | ! I 
i ee 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Ri)) replaces C(C(Cjr)+Cjd). 


Operand Cik Object Code (Hex) 


Types 12345678 
Ri,Cj 0 C6jyi0ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MCC R14,HTYPJ 
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Bao 


INSTRUCTIONS 
MOVE CHARACTER TO CHARACTER 


MCC Ri,Rj 


Type 3 Instruction 
ee ere 


{ { t t 1 

' 1110 ' 0000 ' Ri ! Rj ! 16 

I I ’ t 1 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(C(Ri)) replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types re a 
Ri,Rj EQi j 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
MCC R7,R14 
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aNSTRUCTIONS 


INCREMENT DESTINATION REGISTER AND MOVE IMMEDIATE CHARACTER 


MCI N,R3 


Type 4 Instruction 


| 
1 I ! t | ! 
' 9100 ' 0110 ! Rj ! 0000! N 1 24 
t ! t ' ! 1 | BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Rj) is incremented by one. Then N replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types 123456 
N,Ri 46j0Onn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MCI C'K',R1LS5 
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INSTRUCTIONS 


C MOVE IMMEDIATE CHARACTER UNDER REGISTER CONTROL 
MCI N,Ri,Rj 


Type 4 Instruction 


| | | | 1 ' 

' 0101 ! 0101 ! Ri ! Rj} | N 1 24 

\ 1 ' I ' ! ! BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj}) are compared. If C(Ri) and C(Rj) are equal, 
instruction execution is finished. If not, C(Ri) is incremented 
by one and N replaces C(C(Ri)). The process repeats until 
C(Ri) equals C(Rj). 


Operand Object Code (Hex) 
Types 123456 
N,Ri,Rj 55ijnn 
Rae 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MCI 0,R14,R15 
MCI C' ',R14,R15 


Programming Note: This instructions compares the addresses 
contained in the two registers before incrementing and moving the 
data. This is different from the string instructions, which 
increment before comparing. 
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INSTRUCTIONS 


INCREMENT DESTINATION REGISTER AND MOVE CHARACTER 


MCI Ri,Rj 


Type 3 Instruction 


T T T I ] 
j 1 | j | 
' 1000 |! 0101 |! Ri ! Rj ! 16 
t | | ! ] 


I BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Rj) is incremented by one. C(C(Ri)) replaces C(C(Rj)). 
Operand Object Code (Hex) 
Types 1234 
Ri,Rj B85 i j 

Example 

Label Opc Operand Comment 

Field Field Field Field 

MCI R5,R14 
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INSTRUCTIONS 


MOVE DECIMAL CHARACTER TO BINARY 
MDB Ri,Wj 


Type 5 Instruction 


t ' 1 { { { \ 

' 1101 ! 1010 ! wWjr | Ri! Wk! Wid 1 32 

! { \ 1 ' I ' ! | BITS 
l 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
C(C(Wjr)+Wjd) is multiplied by ten. The binary value of the 


ASCII digit in C(C(Ri)) is added to the product, and the= sum 
replaces C(C(Wjr)+Wjd). 


Operand Wik Object Code (Hex) 
4 5 


Types 12345678 
Ri,Hj 0 DAJjiOoOddd 
Ri,Tj 1 DAjilddd 
Ri,Dj 2 DAji2ddd 
Ri,Fj 3 DAji3dadd 
Example 
Label oOpC Operand Comment 
Field Field Field Field 
MDB R11,STYPI 


Programming Note: If C(C(Wjr)+Wjd) is zero initially, repeated 
use of this instruction with incrementing of C(Ri) will convert 
an ASCII string representing a decimal value into a binary 
integer. — 
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INSTRUCTIONS 


DECREMENT, MOVE STRING UNDER DELIMITER CONTROL WHILE COUNTING 


MDDDC Ri,Rj,N 


Type 4 Instruction 
Toe ee i = ee a ny 


' | I 1 I 

' 9110 |! 0010 ! Ri ! Rj | N 1 24 

' t { | ! | | BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each decremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). C(TO) is decremented by one. 
The character that was moved is then matched with the characters 
Specified by N. If the match is not successful, the operation is 
repeated. 


Operand Object Code (Hex) 
Types 123436 
Ri,Rj,N 62ijnn 
Example 
Label OpC Operand Comment 
Field Field Field Field 


MDDDC R4,R5,X'15"* 


Programming Note: Assuming that TO contains zero before this 
instruction is executed, when execution is completed, the number 
of characters moved will be recorded in TO as a negative number. 
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J 


INSTRUCTIONS 


DECREMENT AND MOVE STRING UNDER DELIMITER CONTROL 


MDDD Ri,Rj,N 


Type 4 Instruction 


I t ! 
; 0110 | 0001 | Ri |} Rj 
| t ' 


= 
tN 
> 


1 2 3 4 5 6 
Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each decremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). The character that was moved is 
then matched with the characters specified by N. If the match is 
not successful, the operation is repeated. 


Operand Object Code (Hex) 
Types 123456 
Ri,Rj,N 61ligjgnn 
Example 
Label OpCc Operand Comment 
Field Field Field Field 
MDDD R11,R7,X'84' 


Programming Note: At least one character is always moved by the 
instruction since the match test is made after the move. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-79 


INSTRUCTIONS 


DECREMENT BOTH REGISTERS AND MOVE CHARACTER 


MDD Ri,Rj 


Type 3 Instruction 


I ! ! ! ! 
' 9110 ' 0000 | Ri ! Rj ! 16 
' { ! 1 ' BITS 
] ee a as es 7 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Rj}) and C(Rj) are each decremented by one. 


Then C(C(Ri)) replaces C(C(Rj)). 
Operand Object Code (Hex) 
Types P22 4 
Ri,Rj 60i j 
Example 
Label OpCc Operand Comment 
Field Field Field Field 
MDD R6,R11 DEC R6 AND Rll, MOVE BYTE 
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INSTRUCTIONS 


DECREMENT AND MOVE STRING UNDER REGISTER CONTROL 


MDDR Ri,R} 


Type 3 Instruction 


5 ' I ' { 
19101 | 1000 ' Ri ! rR} ! 16 
! ] 4 \ 1 BITS 
eS en a 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each decremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). C(Ri) is compared with C(R15). 
If the addresses are not equal, the operation is repeated. If 
C(Ri) is equal to C(R15) initially, no operation is performed. 


Operand Object Code (Hex) 
Types 1234 
Ri, Rj 5 8 i j 
Example 
Label oOpc Operand Comment 
Field Field Field Field 
MDDR R4,R7 


Programming Note: This instruction assumes that R15 contains an 
address equal to or less than C(Ri). 
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INSTRUCTIONS 


DECREMENT AND MOVE STRING UNDER TO AND DELIMITER CONTROL 


MDDTD Ri,Rj,N 


Type 4 Instruction ¢C_ lOlY 


| | | { | ( 
' 0101 '(0100.! Ri ! Rj | N 1 24 
{ ! ] ! { ! 


3 4 5 


— 
NO 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each decremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). C(T0) is decremented by one. If 
C(TO) is zero or if the character moved matches one of the 
characters specified by N, execution ceases; otherwise, the 
operation is repeated. If cC(TQ) equals zero initially, no 
operation is performed. 


Operand Object Code (Hex) 
Types 123456 
Ri,Rj,N SA/ijnn 
A wea” 
Example 
Label Opc Operand Comment 
Field Field Field Field 


Programming Note: This instruction may be used to limit the 
maximum number of characters moved. TO can be initialized with a 
maximum count before this instruction is executed. After 
execution the number of characters moved may be computed by 
subtracting the final count in TO from the initial count. 
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INSTRUCTIONS 


DECREMENT AND MOVE STRING UNDER TO CONTROL 


MDDT Ri,Rj 


Type 3 Instruction 


i] ! ' ! ! 

' 0101 ' 1001 ' Ri ! Rj} ! 16 

I ' ' 1 ! BITS 
i 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each decremented by one. The character which 


is C(C(Ri)) replaces C(C(Rj)). C(T0O) is decremented by one. If 
C(TO) is non-zero, the operation is repeated. If C(TO) equals 
zero initially, no operation is performed. 
Operand Object Code (Hex) 
Types eee eee 
Ri,Rj 591i j 

Example 

Label Opc Operand Comment 

Field Field Field Field 

MDDT R4,R7 
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INSTRUCTIONS 


MOVE FLOATING DECIMAL STRING TO BINARY 


MFBN Ri 3 


Type 3 Instruction 


l ] l 
' 0100 }; 1111 ; Ri ; 0000 | 16 


BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction converts a floating decimal string, pointed to 
by Ri, to a six byte binary number in FPO. A_ floating decimal 
String is a string of ASCII decimal digits that includes an 
optional period (decimal point). The digits that precede the 
period are called integer digits. Digits that follow the period 
are called fraction digits. The first character of the string 
may be a plus sign, a minus Sign, a period, or a decimal digit. 
The string must include at least one digit and must be terminated 
by a system delimiter or a period. 


Several PCB elements must be initialized before the instruction 
executes. FPO, which will receive the converted number, must 
contain zero, H6 must contain a maximum count of integer digits. 
Bits 0-3 of H7 must be zero because they will be used for 
indicators by the firmware. Bits 4-7 of H7 must contain tt 

maximum count of fraction digits. Ri must point to the by‘*n 
preceding the first character in the string. Note that a zero in 
H6 specifies a maximum count of 256 integer digits whereas a zero 
in H7 specifies that there are no fraction digits. Hence, the 
lowest integer digit count is one, and the highest fraction digit 
count is 15. . 


This instruction sets C(ACF). If a number was converted and a 
proper terminator was found, NUMBIT is set to one. FPO contains 
the six-byte result, and Ri points to the terminator. 


The complete ACF byte, including NUMBIT, is set to zero if there 
is a non-decimal digit in the string or if there is no terminator 
where one is expected. If NUMBIT is zero, Ri points to the last 
character processed. 


The ASCII string is converted to a binary number in the six byte 
accumulator FPQ. All of the digits, both integer and fraction, 
are converted into one magnitude. if a period is encountered 
before the specified number of integer digits have been 
processed, the succeeding fraction digits will be converted up to 
the number specified in H7. if C(H7) are greater than the number 
of fraction digits, the results in FPO will be multiplied by 10 


for each missing digit. If C(H7) are zero, integer digits only 
will be converted; that is, processing will stop at the first — 
period or system delimiter. : ) 
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INSTRUCTIONS 
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INSTRUCTIONS 
MOVE FLOATING DECIMAL STRING TO BINARY (cont) ( ) 


The following situations should be kept in mind: 


l. If the first character is a period, there must be some 
fraction digits or NUMBIT will be set to zero. 

2. If the number of integer digits equals C(H6), the 
instruction terminates after converting the integer 
digits. At the conclusion of execution C(Ri) points 


to the last digit converted, not at the terminator. 
NUMBIT is set to zero. 

3% If C(H7) is not zero, processing will terminate at a 
system delimiter. If the number of fraction digits 
equals C(H7), the terminator may be a second period 
rather than a system delimiter. 

4. The instruction does not indicate that a magnitude was 
too large for the accumulator. 


Operand Object Code (Hex) 
Types 1z734 
Ri 4F i 0 
Example wi 
Label Opc Operand Comment 
Field Field Field Field 
H4 HTLY 4 
H8 HTLY 8 
ZERO DO ZERO FPO AND 
ZERO Dl H6 AND H7 
MOV =H4,H6 SET INTEGER SIZE 
MOV =H8,H7 SET FRACTION SIZE 
MFBN R15 
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c 


INSTRUCTIONS 


MOVE HEXADECIMAL STRING TO BINARY 


MXBN Ri 


16 


| BITS 
1 2 3 


© 
— 
© 
© 
_— 
—_ 
ys) 
j~- 
i) 
od © 
i) 
© 


Detailed Description of Instruction Execution 


This instruction converts a hexadecimal string, pointed to by Ri, 
to a six-byte binary number in FPO. A hexadecimal string is a 
sequence of ASCII characters that represent hexadecimal digits. 
The first character of the string may be a plus'7 sign, a minus 
Sign, or a hexadecimal digit. The string must include at least 
one digit and must be terminated by a system delimiter. 


Several PCB elements must be initialized before the instruction 
executes. FPO, which will receive the converted number, must 
contain zero. H6 must contain a maximum count of hexadecimal 
digits. Bits 0-3 of H7 must be zero because they will be used for 
indicators by the firmware. Ri must point to the byte preceding 
the first character in the string. Note that a zero in 4H6 
specifies a maximum count of 256 hexadecimal digits. Hence, the 
lowest digit count is one. 


This instruction sets C(ACF). In particular, NUMBIT is set to one 
if a number was’ converted and a proper terminator was found. 
FPO contains the six-byte result, and Ri points to. the 
terminator. 


NUMBIT is set to zero if there is a non-hexadecimal digit in the 
string or if there is no terminator where one is expected. If 
NUMBIT is zero, Ri points to the last character processed. 


The ASCII string is converted to a binary number in the six-byte 
accumulator FPO. All of the digits are converted into one 
magnitude. Processing will stop at the first ????? period or 
system delimiter. The following situations should be kept in 
minds 


1. If the number of hexadecimal digits equals C(H6), the 
instruction terminates after converting the digits. 
At the conclusion of execution C(Ri) points to the 
last digit converted, not at the terminator. NUMBIT is 
set to zero. 


2. The instruction does not indicate that a magnitude was 
too large for the accumulator. 
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INSTRUCTIONS 


Operand Object Code (Hex) 
Types i234° ) 
Ri 4 F iQ 
Example 
Label Opc Operand Comment 
Field Field Field Field 
K10 HTLY 10 
ZERO DO ZERO FPO AND 
ZERO D1 H6 AND H7 
MOV K10,H6 SET INTEGER COUNT 
MXBN R14 
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INSTRUCTIONS 


INCREMENT SOURCE REGISTER AND MOVE CHARACTER 


MIC Ri,Rj 


Type 3 Instruction 


t ( 1 { ] 

' 0100 |! 0111 ! Ri ! RY ! 16 

t J ' ' ( BITS 
I 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) is incremented by one. C(C(Ri)) replaces C(C(Rj)). 
Operand Object Code (Hex) 
Types 1234 
Ri,Rj 47ij 

Example 

Label Opc Operand Comment 

Field Field Field Field 

MIC R5,R14 
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INSTRUCTIONS 


( 
INCREMENT, MOVE STRING UNDER DELIMITER CONTROL WHILE COUNTING “al 


MIIDC Ri,Rj,N 


Type 4 Instruction 


{ i t 

; 0100 ; 0010 ; Ri j{ Rj N 24 

j 1 1 { ( { { BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) C(Rj) are each incremented by one. The character which is 
C(C(Ri)) replaces (C(C(Rj)). C(TO0) is decremented by one. the 
Character that was moved is then matched with the characters 
specified by N. If the match is not successful, the operation is 
repeated. 


Operand Object Code (Hex) 
Types 123436 
Ri,Rj,N 42ijnn 
Example al 
Label Opc Operand Comment 
Field Field Field : Field 
MIIDC R14,R8,X'84' 


Programming Note: Assuming that TO contains zero before this 
instruction is executed, when execution is completed, the number 
of characters moved will be recorded in TO as a negative number. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SE?°88 2-90 


INSTRUCTIONS 


INCREMENT AND MOVE STRING UNDER DELIMITER CONTROL 


MIID Ri,Rj,N 


Type 4 Instruction 


We Mg ee ee ae 


1 ’ I { ! t 

' 0100 | 0001 ! Ri ! Rj ! N 1 24 

I ’ j I | l { BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are incremented by one. The character which is 
C(C(Ri)) replaces C(C(Rj)). The character that was moved is then 
matched with the characters specified by N. If the match is not 
successful, the operation is repeated. 


Operand Object Code (Hex) 
Types 123456 
Ri,Rj,N 4lijonno 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MIID R7,R11,X'DO' 


Programming Note: At least one character is always moved by this 
instruction since the match test is made after the move. 
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INSTRUCTIONS 


INCREMENT BOTH REGISTERS AND MOVE CHARACTER -_ 


MII Ri,Rj 


Type 3 Instruction 


t j I 1 1 

' 0100 ! 0000 ! Ri ! Rj} ! 16 

I { ! J 1 BITS 
1 2 5 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each incremented by one. Then C(C(Ri)) 
replaces C(C(R})). 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 400i j 
Example 
Label Opc Operand Comment wa” 
Field Field Field Field 
MII R14,R15 
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INSTRUCTIONS 


INCREMENT AND MOVE STRING UNDER REGISTER CONTROL 


MIIR Ri,Rj 


Type 3 Instruction 


1 i 1 T | 


! I I ! I 

' 0101 ! 0000 ' Ri ! Rj ! 16 

' ' ‘ ! I BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each incremented by one. The character which 
is C(C(R1)) replaces C(C(Rj)). C(R1) is compared with C(R15). 
If the addresses are not equal, the operation is repeated. If 
C(Ri) is initially equal to C(R15), no operation is performed. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 5 0i j 
Example 
Label OpC Operand Comment 
Field Field Field Field 
MIIR R6,R3 


Programming Note: This instruction assumes that R15 contains an 
address equal to or greater than C(Ri). 
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INSTRUCTIONS 


| 
INCREMENT AND MOVE STRING UNDER TO AND DELIMITER CONTROL | ) 
MIITD Ri,Rj,N 


Type 4 Instruction 


l BITS 
1 2 3 4 5 


Detailed Description of Instruction Execution 


C(Ri) and C{Rj) are each incremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). C(T0O) is decremented by one. cf 
C(TO) is zero or if the character moved matches) one of the 
characters specified by N, execution ceases; otherwise, the 
Operation is repeated. if C(TO) equals zero initially, no 
operation is performed. 


Operand Object Code (Hex) 
Types 12345 6 
Ri,Rj,N 552i jnn 
Example ww 
Label Opc Operand Comment 
Field Field Field Field 


Programming Note: This instruction may be used to limit the 
maximum number of characters moved. TO can be initialized with a 
maximum count before this instruction is executed. After 
execution the number of characters moved may be computed by 
subtracting the final count in TO from the initial count. 
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INSTRUCTIONS 


INCREMENT AND MOVE STRING UNDER TO CONTROL 


MIIT Ri,Rj 


Type 3 Instruction 


aa (aa ce, 


{ | | { I 

' 0101 ! 0001 ! Ri ! Rj !~ 16 

I I l | 1 BITS 
l 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are each incremented by one. The character which 
is C(C(Ri)) replaces C(C(Rj)). C(TO) is decremented by one. If 
C(TQ) is non-zero, the operation is repeated. If C(TQO) equals 
zero initially, no operation is performed. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 5 1i j 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MIIT R7,R4 
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INSTRUCTIONS 


MOVE, ATTACH.D, STORAGE REGISTER TO REGISTER 
MOVA Si,Rj 


Type 5 Instruction 


T I I T i i { 
! ! ! 1 I | ! 
! 1011 ! 1001 1 Sir 1 Rj | Sik ! Sid | 32 


1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


This instruction moves C(C(Sir)+Sid) to Rj}. When the instruction 
has finished execution, Rj will be attached if three conditions 
hold: 1) Rj was already attached, 2) Si's FID field contains the 
same value as Rj's FID field, and 3) Si contains a normalized 
displacement. If all three conditions are not met, the 


instruction works just like the MOV Si,Rj instruction. 


Rj's linked/unlinked flag is set to agree with Si's flag byte. 


Operand Wi Object Code (Hex) 


Types 12345678 
Si,Rj B9ij3ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MOVA STYPI,R12 


Programming Note: Functionally, this instruction is the same as 


MOV Si,Rj, but it may leave the register in an attached < cate. 


This only affects code that depends on MOV Si,Rj to detach a 
register. The instruction is intended to speed up software when 
data are being manipulated within one frame. If the register 
cannot remain attached, this instruction is slightly slower than 


MOV Si,Rj; otherwise, it is several times faster. 
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J 


c 


INSTRUCTIONS 


MOVE BIT TO BIT 


MOV Bi,Bj 


Type 6 Instruction 


de 0 Se Se we ep ee pe a ee ee pean green |e 


I 

I { ( ! { t | 
; 1111 ; 0101 ; Bir ; Bjr ; io |, Bid ; 
! I | | { { | 1 | 
ee 

1 2 3 4 5 6 7 8 

Ss 

| ’ 1 

1 jo 4 Bjd | 

i { | I I 

I 

9 10 ll 12 


Detailed Description of Instruction Execution 


C(C(Bir)+Bid) is moved to C(C(Bjr)+Bjd). 


Operand Object Code (Hex) 
Types 1234567899012 
Bi,Bj F5ijyoddqdoddd 


o is 8 plus the bit offset in the byte. 


Example 
Label Opc Operand Comment 
Field Field Field Field 


MOV BTYPI,BTYPJ 
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INSTRUCTIONS 


MOVE ADDRESS REGISTER TO ADDRESS REGISTER ) 
MOV Ri,Rj 


Type 3 Instruction 


( \ I I { 

' 9000 | 0011 | Ri ! Rj |! 16 

( ! ' ' ] BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) replaces C(Rj). C(Ri) is not changed. If Ri was attached, 
Rj becomes attached; otherwise, Rj is detached. 
Operand Object Code (Hex) 
Types 1234 
Ri,Rj O03 i j 
Example 
Label Opc Operand Comment 
Field Field Field Field ) 
MOV R7,R15 
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INSTRUCTIONS 
STORE ADDRESS REGISTER 
MOV Ri,Sj 


Type 5 Instruction 


T T T l I T ] 
| $ ! | t | | 
; 1100 ; 1010 ; Sjr ; Ri} Sjk | Sjd 1 32 
! I ] 


i ! BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


The detached form of C(Ri), that is, displacement, link and FID, 
replaces C(C(Sjr)+Sjd). C(Ri) is not changed, not even detached. 


Operand Wik Object Code (Hex) 


Types 12343678 
Ri,Sj 3 CAji3g3dadd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MOV R2,STYPJ — 
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INSTRUCTIONS 


LOAD ADDRESS REGISTER 
MOV Si,Rj 


Type 5 Instruction 


| \ i ! ! ! 

' 1011 ! 1010! Sir! Rj ! Sik! Sid 32 

1 t ’ | t 1 t t t BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
Rj is detached and then C(C(Sir)+Sid) replaces the six low-order 


bytes (displacement, link and FID) of Rj. The high-order two 
bytes of Rj are set to zero. 


Operand Wik Object Code (Hex) 


Types 12345678 
Si,Rj 3 BAij3dadd 
Example 
Label oOpc Operand Comment 
Field Field Field ; Field 
MOV STYPI,R15 


Programming Notes: Since the address registers can be addressed 
as storage locations, they can be changed by using other move 
instructions. However, this may lead to problems in the future if 
the address register philosophy changes. For simplicity use only 
the Load Address Register instruction to move an address into an 
address register. 
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INSTRUCTIONS 


MOVE ELEMENT TO ELEMENT 


C MOV Wi,Wj 


Type 6 Instruction 


| ma 1 T ] i ] } 
t ! ( ! t ] 
‘ 1111 {| 0011 | Wir Wik | Wid 
' { 1 | i] ! 


= 
: 
ry 


1 2 3 4 5 6 7 8 
ee ge ee 
aaa | 3 
1 Wk , Wid 48 
| I ! t ! BITS 
9 10 11 12 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) replaces C(C(Wjr)+Wjd). 


Operand Wik Wik Object Code (Hex) 

Types 123456789012 
Ci,Cj 0 0 F3rrQdddoddd 
Hi,Hj 0 0 F3rrQ0dddoddd 
Ti, Tj 1 1 F3rrildddtiddd 
Di,Dj 2 2 F3rr2daqaddq2ddd 
Fi,F) 3 3 F3rr3dqdda3ddd 

wd Si,Sj 3 3 F3rr3ddd3ddd 
Vi,Vj 7 7 F3rr7@dadaddfT7ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
MOV HTYPI,HTYPJ 
MOV CTYPI,CTYPJ 
MOV TTYPI,TTYPJ 
MOV DTYPI,DTYPJ 
MOV FTYPI,FTYPJ 
MOV STYPI,STYPJ 


Programming note: The assembler allows the mnemonic format MCC 
C,C as well as MOV C,C. 


Although this is the only instruction that moves tallies, double 
tallies or triple tallies, there are other instructions that move 
single characters or character strings from storage to storage. 
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INSTRUCTIONS 


MULTIPLY BY 10 
MUL10 Wj 


Type 5 Instruction 


| | ! ] ] { 

' 1011 ' 0001 | Wjr ! 0000! Wik ! wid i 39 

( | j { | { j J I BITS 
l 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Wjr)+Wjd) is multiplied by 10. 


Operand Wik Object Code (Hex) 


Types 12345678 
Hj 0 B1ljOOddd 
Tj 1 BljQiddd 
Dj 2 BljO2dadd 
Fj 3 BljoO3dadd 
Example 
Label Opc Operand . Comment 
Field Field Field : Field 


MUL10 HTYPI 
MUL10 FTYPJ 
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-: * tS - oe) blr tad Come we - a 


INSTRUCTIONS 


MULTIPLY BY SCALE 
MULS Wi 


Type 5 Instruction 


| ' 1 | { | ! 

; 1011 ; 0000 | Wir ; 0000 } Wik } Wid 32 

] ] b I ! J | | ! BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


The six-byte accumulator (FPO) is multiplied by 10 the number of 
times specified by the low-order byte of C(C(Wir)+Wid). A 12-byte 
number is the result. The high-order six bytes of the result are 
placed in FPY, and the low-order six bytes are placed in FPO. 


Operand Wik Object Code (Hex 
Types — 22345678 
Hi 0 BQO iododgddd 
Ti 1 BOioglddd 
Di 2 BO iodg?2zgddd 
Fi 3 BO iodg3ddd 
Example 
Label Opc Operand Comment 
Field Field Field ' Field 
MULS TTYPI 
MULS FTYPJ 


Programming Note: Although large operands can be addressed, only 
the low-order byte of Wi is used so the largest scale value is 
255. 
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INSTRUCTIONS 


MULTIPLY 
MUL Wi 


Type 5 Instruction 


| | ] 1 1 | 

' 7011 ' CO11 ' Wir ! 0000 ! Wik | Wid | 39 

’ { ! { ( | | 1 t BITS 
eg e 3 4 = Go 9 


Detailed Description of Instruction Execution 


C(DO) is multiplied by C(C(Wir)+Wid). An 8-byte product replaces 
C(D1) and C(DO). 


The sign of the product is determined by the rules of algebra. 


C(ACF) is updated to reflect overflow. 


Operand Wik Object Code (Hex) 
12 3 7 


Types 12345678 
Hi 0 B3i00ddd > 
Ti 1 B3i0lddd 
Di 2 B3i02dadd 
Vi 7 B3iO0O7dqdd 

Example 

Label Opc Operand Comment 
Field Field Field Field 
MUL DTYPI ° DTYPI * DO 
MUL FTYPJ FTYPJ * FPO 


Programming Note: The mnemonic MUL may be used with F type 
operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction MULX. 


J 
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INSTRUCTIONS 


MULTIPLY EXTENDED 
MULX Wi 


Type 5 Instruction 


T ! { { T i] ] 
j | | | } 
1011 ' 0010 ' wir ' 0000 ! Wik! Wid i 32 
] | { ] ] ! 


i 
| BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
C(FPO) is multiplied by C(C(Wir)+Wid). A 12-byte product 


replaces C(FPY) and C(FPO). The sign of the product is 
determined by the rules of algebra. 


Operand Wik Object Code (Hex) 
1 2 3 


Types 12345678 
Hi 0 B2i0do0ddd 
Ti 1 B2io0d0lddd 
Di 2 B2io0d2dadd 
Fi 3 B2iod3dadd 
Vi 7 B2io0d07dqdd 
Example 
Label OpC Operand Comment 
Field Field Field Field 
MULX HTYPI MULTIPLY FPO 


Programming Note: The mnemonic MUL may be used with F type 
operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction MULX. 
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INSTRUCTIONS 


MOVE HEXADECIMAL CHARACTER TO BINARY ) 
MXB Ri,Wj 


Type 5 Instruction 


Sh ss ee a et, «6S 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Wjr)+Wjd) is multiplied by sixteen (that is, shifted left 
four bits). The binary value of the ASCII hexadecimal digit in 
C(C(Ri) is added to the product, and the result replaces 
C(C(Wjr)+Wjd). 


Operand Wik Object Code (Hex) 
4567 


Types 12345678 
Ri,Cj 0 DEjioddd 
Ri,Hj 0 DEjioddd 
Ri,Tj 1 DEjidlddd 
Ri,Dj 2 DEji2ddd 
Ri,Fj 3 DEjig3gdadd 
Example 
Label Opc Operand Comment 
Field Field Field ; Field 
MXB R14,FTYPJ 


Programming Note: If C(C(Wjr)+Wjd) is initially set to zero, 
repeated use of this instruction with incrementing of C(R) will 
convert an ASCII string representing a hexadecimal value into a 
binary integer. 
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INSTRUCTIONS 


NEGATE 
NEG Wj 


Type 5 Instruction 


! | ! ! t t i 

' 1010 ! 1010 ! wir ! 0000 ! Wijk | Wid : 2 

! | t 1 ! j { ! 1 BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Wjr)+Wjd) is replaced with its two's complement form. 


Operand Wik Object Code (Hex) 
4567 8 


Types 12345678 
Hj 0 AAjJO Oddd 
Tj 1 AAJOlddd 
Dj 2 AAjJO2ddd 
Fj 3 AAjJ QO 3ddd 
Vj 7 AAjJOQOQ 7dadd 
Example 
Label oOpc Operand — Comment 
Field Field Field Field 
NEG TTYPJ 
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INSTRUCTIONS 
NO OPERATION ) 


NOP 


Type 1 Instruction 


2 es eas 

] ] 

' 9000 | 1111 ! 8 

! ! | BITS 
I 2 


Detailed Description of Instruction Execution 


This instruction causes the CPU to take the next instruction in 
sequence. 


Operand Object Code (Hex) 
Types 12 
0 F 
Example 
Label Opc Operand Comment = 
Field Field Field Field 
NOP 
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INSTRUCTIONS 


STORE A ONE 
ONE Wj 


Type 5 Instruction 


yl ! i i { 

| | I \ ! { | 

| 1100 ; 0001 ; Wjr 1 0000 ; Wik | Wid , 39 
{ i 


DA se a ee | CE 
n 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Wjr)+Wjd) is replaced by a binary one with leading zeros. 


Operand Wik Object Code (Hex) 
234567 8 


Types 1234567 8 
Hj 0 C1ljoodddd 
Tj 1 C1ljoOoOiliddd 
Dj 2 C1ljO2ddd 
Fj 3 C1ljo0o?s3daqdd 
Vij 7 C1lj0O7ddd 
Example 
Label Opc Operand - Comment 
Field Field Field Field 
ONE FTYPJ SET TO 1 
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INSTRUCTIONS 


OR WITH IMMEDIATE 


OR Rj,N 
OR N,Rj 


Type 4 Instruction 


Ba Ra Sa a a an 


! { | \ ( | 

; 1000 ; 0010 ; Rj j{ 0000 |} N 24 

' ’ | | ] ! { BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(C(Rj)) is logically ORed with N. The result replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types 123456 
Rj,N 82jo0nn 
N,Rj 82joO0Onn 
Example 
Label Opc Operand Comment 
Field Field Field - Field 
OR R6,X'C' 
OR X'D',RS 
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INSTRUCTIONS 


OR WITH STORAGE 
OR Rj,Ri 


Type 3 Instruction 


! ! | ! | 

; 2E20:.; 0010 Ri | Ri 4 16 

I 1 I ] ’ BITS 
1 2 3 4 


Detailed Description of Instruction Execution 
C(C(Rj)) is logically ORed with C(C(Ri)). 


The result replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types L234 
Rj,Ri E2ji 
Example 
Label OpCc Operand Comment 
Field Field Field Field 
OR R15,R14 
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INSTRUCTIONS 


OR ELEMENT WITH ELEMENT 
OR Wi,W} » 


Type 6 Instruction 


I 
| ] | ! | ! | 
' 4111 ! 1100 ! Wir ! Wjr ! Wik | wid ! 
] | i I ! ! | 


‘ ] 
Se nh a) a 
l 2 3 4 5 6 7 8 
oe 
1 1 | 
' Wyk ! wid 48 
{ i 1 { ! pT 
9 10 11 12 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is logically ORed with C(C(Wjr)+Wjd). The result 
replaces C(C(Wjr)+Wjd). 


Operand Wik Wjk Object Code (Hex) 

Types _ 123456789012 
Ci, C) 0 0 FBrrQOddddoqoddd 
Hi,Hj 0 0 FBrrQddddogddd 
Tis tT) 1 1 FBrrildddtlddd 
Di,Dj 2 2 FBrr2dddqa2ddd j 
Fi,Fj 3 3 FBrr3dqdqdaq3dadd 
Vi,Vj 7 7 FBrridddfT7fddd 

Example 

Label Opc Operand ~— Comment 
Field Field Field Field 
OR HTYPI,HTYPJ 
OR CTYPI,CTYPJ 
OR TTYPI,TTYPJ 
OR DTYPI,DTYPJ 
OR FTYPI,FTYPJ 
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INSTRUCTIONS 


POP NUMBER 


POPNR Ri 
POPN (The assembler's OSYM uses R3 for Ri) 


Type 3 Instruction 


| 1 1 ! | 

; 1001 {| 1111 ; Ri j| 0000 |} 16 

! ! ] ' 1 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


The purpose of this instruction is to pop a number off the stack 
and store it in the extended accumulator. 


The stack pointer (Ri) is decremented by 10. 


If the descriptor type code at Ri;CO has the low-order bit set, 
the number in bytes Ri;C2 through Ri;C7 is copied to _ the 
extended accumulator (FPO). 


If the stack pointer would be decremented past the beginning of 
the buffer, or if the low-order bit of the type code is zero, the 
pointer is not decremented. A BSL using the second entry of the 
branch table is executed instead. 


Operand Object Code (Hex) 
Types 234°" 
Ri 9 Fi 0 
Example 
Label Opc Operand Comment 
Field Field Field Field 
POPNR R4 
POPN 


Caution: The software that is invoked by the BSL may assume that 
R3 is the stack pointer. 
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INSTRUCTIONS 


POP STRING ) 


POPSRR Ri,R}j 
POPS (The assembler's OSYM uses R3 for Ri and R10 for Rj) 


Type 3 Instruction 


er a ee a eae OO a ce le 


{ ' { i { 

' 1110 ! 1111 } Ri! Rj ! 16 

i I ’ J 1 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 

The purpose of this instruction is to pop a string off the stack. 
The stack pointer (Ri) is decremented by 10. 

If the descriptor type code at byte Ri;CO is the direct string 
type code (i.e., X'02'), the stack pointer (Ri) is moved to the 
string pointer (Rj). That is, C(Ri) replaces C(Rj). 


If the descriptor type code at byte Ri;CO has the high order bit 
set, the contents of the storage register at bytes Ri;C2 through 


Ri:C7 are moved to the string pointer (Rj). That is, the si: 


bytes starting at the location C(Ri)+2 replace C(Rj). 


If the stack pointer would be decremented past the beginning of 
the buffer, or if the descriptor type does not have the high- 
order bit set and is not equal te X'02', the pointer is not 
decremented. A BSL using the fourth entry in the branch table is 
executed instead. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj EF i 3 
Example 
Label Opc Operand Comment 
Field Field Field Field 


POPSRR R4, RS 
POPSR R4 
POPS 


Caution: The software that is invoked by the BSL may assume that 
R3 is the stack pointer. 
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J 


INSTRUCTIONS 


PUSH DESCRIPTOR 


PUSHD Ri,Rj 
PUSHD Ri (The assembler's OSYM uses R3 for Rj) 


Type 3 Instruction 


{ ] ( ' ! 

' 1110 | 1100 } Ri {| Rj 3 16 

! { ' ] ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction pushes a descriptor onto the stack. It copies 
the 10 bytes referenced by Ri;CO through Ri;C9 (the descriptor) 
to the stack referenced by Rj;CO through Rj;C9. Rj is then 
incremented by 10. 


If the descriptor type code is zero (that is, if the byte 
referenced by Ri;C0O contains X'00'), a BSL is executed using the 
third entry of the branch table. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj EC i j 
Example 
Label Opc Operand Comment 
Field Field Field Field 


PUSHDRR R4, RS 
PUSHD R4 


Cautions: If the 10 bytes referenced by Rj cross a frame limit, a 
CROSSING FRAME LIMIT abort will result. 


Cautions If the 10 bytes referenced by Ri cross a frame limit a 
CROSSING FRAME LIMIT abort will result. 


Caution: The software that is invoked by the BSL may assume that 
R3 is the stack pointer. 
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INSTRUCTIONS 


PUSH NUMBER 


| wR, 


PUSHNR Rl 
PUSHN (The assembler's OSYM uses R3 for Ri) 


Type 3 Instruction 
pe ge ne — ee 


| ! I i t 

| 1001 ; 1011 ; Rij; 0000 } 16 

! I 1 1 t BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction pushes a numeric descriptor onto the stack. It 
writes the numeric code X'0Ql1' into the byte referenced by Ri;Cc0 
and copies the number from the extended accumulator (FPO) to 
bytes Ri;C2 through Ri;C7. The stack pointer (Ri) is then 
incremented by 10. 


Operand Object Code (Hex) 
Types 1234 
Ri 9 Bi Q 
wal 
Example 
Label Opc Operand . Comment 
Field Field Field Field 
PUSHNR R4 
PUSHN 


Caution: If the 10 bytes referenced by Ri cross a frame limit, a 
CROSSING FRAME LIMIT abort will result. 
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INSTRUCTIONS 


PUSH INDIRECT STRING 


PUSHS Ri,Rj 
PUSHS Ri (The assembler's OSYM uses R3 for Rj) 


Type 3 Instruction 


I ' ' ! ' 

' 1110 ! 1101 ! Ri ! Rj ! 16 

{ t ' ' | BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction pushes an indirect string descriptor onto the 
stack. It writes the indirect string type code X'82' into the 
byte referenced by Rj};CO and moves the contents of Ri to the 
storage register at bytes Rj;C2 through Rj;C7. The stack printer 
(Rj) is then incremented by 10. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj EDi j 
Example 
Label Opc Operand ~— Comment 
Field Field Field Field 


PUSHSRR_ R4,R5 
PUSHS R4 


Caution: If the 10 bytes referenced by Rj cross a frame limit, a 
CROSSING FRAME LIMIT abort will result. 
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INSTRUCTIONS 


PUSH TEMPORARY STRING ; 


PUSHTS Ri,R}j 
PUSHTS Ri (The assembler's OSYM uses R3 for Ri) 


Type 3 Instruction 
aa aaa Sam Lc 


\ t J J ! 

' 1110 ! 1110 !' Ri ! Rj ! ~~ 16 

' t ! § ! BITS 
l 2 3 4 


Detailed Description of Instruction Execution 


This instruction pushes a temporary string descriptor onto the 
Stack. It writes the temporary string type code X'C2' into the 
byte referenced by Rj};CQ and moves the contents of Ri to the 
storage register at bytes Rj;C2 through Rj;C7. The stack pointer 
(Rj) is then incremented by 10. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj EE i j 
Example 
Label oOpc Operand . Comment 
Field Field Field Field 


PUSHTSRR R4,R5 
PUSHTS R4 


Cautions If the 10 bytes referenced by Rj cross a frame limit, a 
CROSSING FRAME LIMIT abort will result. 
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Se 


INSTRUCTIONS 


QUEUE COMMAND 


QCMD N 


Type 2 Instruction 


Qe ee Se ge = We ge ae a Oe lly 


| | ’ ( 

; 0110 ; 0110 | N 16 

| I ! | ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction queues a command for the input/output processor. 
The command is the value N. 


Note that there are several mnemonics in OSYM that generate this 
instruction with different values for N, for example, IORESET and 
IOKILL. The mnemonic QCMD would not ordinarily be used in a mode. 


The following input interface is required : 


Element Description 


HO Channel number 
Hl Controller number 
H2 IOP2 address 
Operand Object Code (Hex) 
Types 1234 | 
N 66nn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
IORESUME * CONTINUE I/O 
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INSTRUCTIONS 


QUEVE I/O REQUEST 


QIO_ Ri,N J 


Type 4 Instruction 


! ( § I ! { 

(+ 0110 | 1000 ; Ri ; 0000 } N 24 

| { i ! | t I BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


This instruction initiates the transfer of a task descriptor (TD) 
to the input/output processor. C(Ri) points to the task 
descriptor defining an I/O operation. The TD contains the number 
of the controller for which action is desired. 


N defines the service request with one of the following values: 


Value Meaning 

(Hex ) 

01 Queue the TD to the tail of the queue of TDs for this 
controller (normal data flow); 

02 Queue the TD to the head of the queue of TDs for thi- 
controller (expedited data flow); J 

03 Execute this TD without regard to the queue of TDs for 


this controller (error recovery). 


If the controller number specified in the TD indicates that the 
transfer is to another process in the same computer, the TD will 
be transferred to the other process provided the intended 
recipient process has initiated a receive TD. Otherwise, the 
effect of this instruction is that the queue command and TD are 
queued to the [0-Circular-Queue of an IOP. The specific IOP is 
specified in the body of the TD. 


On completion of the instruction, HO will contain the result of 
the operation with one of the following codes: 


Code Meaning 

(Hex) 

00 I/O issued; 

OD I/O queue full; 

OE Invalid IOP address in TD; 

OF Invalid type field in TD (completion handler pike | 
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C 


INSTRUCTIONS 


QUEUE I/O REQUEST (cont) 


HO containing X'00' indicates that the transfer was issued, not 
that the transfer completed without error. When a TD is dequeued 
by means of the DQIO Rj,N instruction, it's status bytes must be 
checked to determine the outcome of the request. 


Code X'0D' can only be returned in monitor mode. In virtual mode 
the process is roadblocked until there is room in the queue. The 
Monitor should loop on the QIO instruction while counting to some 
number that indicates remedial action should be taken. 


Codes X'OE' and X'OF' mean that the I/O request was rejected. 


Operand Object Code (Hex) 
Types 123456 
Ri,N 68iOQOnn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
QIO R3,X'O1' QUEUE UP TD 
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INSTRUCTIONS 


ws 


REGISTER DETACH AND SET DISPLACEMENT TO ONE 


RDETO Rj 


Type 3 Instruction 


{ ’ | i ’ 

' 9001 | 0111 | Rj 1! 0000! 16 

1 ' i ! i BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


If Rj is attached, it is detached, and its displacement field is 
set to one. 


If Rj is detached, its displacement field is set to one. 


Operand Object Code (Hex) 
Types ae 
Rj 17j 0 
Example 
Label Opc Operand | Comment 
Field Field Field Field 


Programming Note: This instruction replaces the use of the ONE W 
instruction to detach a register and set its displacement field 
to one. 
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INSTRUCTIONS 


REGISTER DETACH AND SET DISPLACEMENT TO ZERO 


RDETZ Rj 


Type 3 Instruction 


| i | t J 

' 0001 ' 0110 ! Rj |! 0000! 16 

! ! ! J ’ BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


If Rj is attached, it is detached, and its displacement field is 
set to zero. 


If Rj is detached, its displacement field is set to zero. 


Operand Object Code (Hex) 
Types 1234 
R3 16j0 
Example 
Label oOpc Operand Comment 
Field Field Field ; Field 


Programming Note: This instruction replaces the use of the ZERO W 
instruction to detach a register and set its displacement field 
to zero. 
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INSTRUCTIONS 
READ INDIRECT 
READI Di,Rj a 


Type 5 Instruction 


1 5 | | 1 ( | 

' 1010 ! 1011 ! Dir ! Rj ! Dik! Did | 32 

] 1 ! { ! | ] I | BITS 
I 2 3 r 5 6 7 8 


General Description of Instruction Execution 

Because this instruction is quite complex, a general description 
useful to assembly language programmers is given here and further 
details are provided below. 


This instruction commands the I/O processor to accept characters 
from a process's I/O device and transfer them to main memory. 


The C(C(Dir)+Did) is as follows: 


tally timeout count in tenths of a second 
byte read command 
byte mask of active delimiters ) 


Rj} points to the input buffer. 


The mask specifies which characters are to be treated as 
terminators. Some read commands do not use this mask, in which 
cases it will be ignored. : 


Before the instruction is executed, TO must contain the maximum 
number of characters to be read. The maximum number of characters 
that may be specified in TO is 256. A value less than one will 
result in no operation. 


It is not valid to use this instruction to request a read that 
may cross a frame boundary. Hence, Rj must point to a byte in a 
frame that will allow the number of characters specified in TO to 
be read. 


There are several read commands described in the I/O processor 
firmware specification which can be used in Di. However, assembly 
language programmers are encouraged to use macros’ defined in 
OSYM. These macros are READ, READW, READX, and READL. 


The I/O processor uses the mask for the active delimiters if the 
read command specifies its use. Each mask bit that is equal to l 
tells the I/O processor that it should terminate the input if the 
corresponding character is entered: J 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-124 


INSTRUCTIONS 


Cc READI (cont) 


Bits 
(L_ to R) Meaning 

0 Unassigned 

1 Stop input on control-I (TAB) 

2 Stop input on ESCape 

3 Stop input on control-P 

4 Stop input on control-N 

5 Stop input on either carriage return or linefeed 

6 Stop input on the character in Terminal I/O Workspace 
byte TSC3 

7 Stop input on the character in Terminal I/O Workspace 
byte TSC2 


If the variable delimiters specified in the two low-order bits of 
the mask are to be used, they must be loaded into Terminal 1/0 
Workspace bytes TSC2 and/or TSC3 prior to executing’ the 
instruction. The delimiter character will not be echoed to the 
I/O device but will be included in the transfer to main memory. 


Instruction execution ends when either the number of characters 

specified in TO has been read or the specified terminator is 
| entered. TQ contains the original count less the number of 
C characters read. Tl contains the the number of characters read. 


If the virtual process is a TIPH process, that is, if the PIB 


PHANTOM bit is a 1, the instruction traps to the Software 
Debugger and does not perform any I/O. 


Operand Wik Object Code (Hex) 


Types 12345678 
Di,Rj 1 ABijlddd 
Example 
Label Opc Operand Comment 
Pield Field Field Field 
MOV TIMOUTREAD,DTYPI GET COUNT, COMMAND, MASK 


READI DTYPI,R13 
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INSTRUCTIONS 


READ (cont ) ) 
Detailed Description of Instruction Execution 


When the firmware executes this instruction, it first checks 
COPY.FLG in the Terminal I/O Workspace. If COPY.FLG .s not set, 
the firmware sets up the Read task descriptor. This includes 
moving the two bytes in TSC2 and TSC3 from the Terminal I/0 
Workspace to IOADDR1 and IOADDR2, respectively, and storing Nm in 
the IOADDRO field of the READ task descriptor. The firmware 
issues a QIO command to the I/O processor. The Read task 
descriptor points to the corelocked input buffer pointed to by 
the INPUT.BUF field in the Terminal I/O Workspace. The firmware 
next sets input roadblock, sets READ.IN.PROGRESS to 1, removes 
the PIB from the Priority Queue, and backs up the program counter 
to point to the READ instruction. 


Since the PIB has been removed from the Priority Queue, the 
process will not run. When the 1/0 processor has completed the 
read, it interrupts the CPU. The CPU firmware clears the input 
roadblock, sets COPY.FLG to 1, and puts the PIB at the top of the 
Priority Queue. When the process runs again, the READ instruction 
will be re-executed. This time COPY.FLG will be set. The firmware 
checks the validity of the virtual data address, copies the data 
from the corelocked input buffer to the virtual process's buffer, 
sets that buffer's status to write required, and resets COPY.FLC 
It subtracts the contents of LENGTH.TRANSFERRED (in the Reare 
task descriptor) from the contents of TO, putting the difference 
back into TO, and copies the contents of LENGTH.TRANSFERRED into 
Tl. The firmware then goes to RNI_ to execute the next 
instruction. Q 


Terminal I/O errors are reported by the I/O processor to _ the 
firmware via the Status task descriptor and never by the Read 
task descriptor itself. Therefore, when aterminal error is 
reported, the Read task descriptor remains active and the process 
enters the Software Debugger. The firmware transfers to Software 
Debugger entry-point 10 for the BREAK key and to entry-point 12 
for other terminal errors. If one or more of PRGERR (PIB byte l, 
bit 2) or INDEBUG (PIB byte 1, bit 1) or INCCB (PIB byte X'10', 
bit 0) or PHANTOM (PIB byte 0, bit 7) is set to 1, BREAK key is 
ignored. 


Handshaking errors between the controllers and the CPU may occur 
during I/O operations. These errors may be reported using the 
Read task descriptor as well as the Status task descriptor. 
Whenever the firmware detects a handshake error, it aborts to 
entry point 20 of the Software Debugger. 


The Monitor may not use the READ instruction for terminal infut; 
it must issue terminal I/O task descriptors in the same manner 
that it does for other 1/0 devices. If this instruction iy 
executed in monitor mode, the Firmware Debugger will be entered. 
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INSTRUCTIONS 


READ (cont) 


If the corelocked circular output buffer in the Sequel memory 
(the buffer pointed to by the OUTPUT.BUF field in the Terminal 
I/O Workspace) is not empty when this instruction is encountered, 
the output roadblock is set (OBYTEBLK/ is zeroed), the 
READ.PENDING bit is set, a firmware release quantum entry to the 
Monitor is taken, and the instruction is not executed. When the 
output buffer becomes empty, the output roadblock will be cleared 
so that the READ instruction will be re-executed. 


Generally, the I/O processor will terminate input when either the 
maximum byte count runs out or a terminator character is 
entered. The actual method of termination is determined by the 
definition of the specific read command in Nc. 


The read commands are defined in the “IOP2 Firmware 
Specification", FS20032441. 


If the process is a TIPH process, that is, if PIB PHANTOM bit is 
al, the READ instruction will trap to the Software Debugger and 
not perform any I/O. First, all the error checks are made. The 
virtual storage address of the terminal I/O buffer will be stored 
in the PIB at field PH.WRITER2. The Software Debugger is then 
entered at entry point 17. 
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INSTRUCTIONS 


READ PROM Jd 


RPROM Rj 


Type 3 Instruction 


1 1 ! ' { 

; 1001 ; 0101 ; Rj |; 0000 | 16 

! ) 1 { ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


After attaching Rj, this instruction performs a PROM read and 
stores the data in the bytes pointed at by C(Rj). 


The following information is stored: 


Byte Information 
0 Reserved 
1 Reserved 
2 Reserved 
3 Reserved 
4 PROM microcode version 
) WCS microdoce version -_ 
6-9 4-byte system serial number ww 


The system serial number is read from a system configuration PROM 
which includes a checksum byte. If the checksum is correct, ACF 
bit NUMBIT is set: if the checksum is not correct, NUMBIT is 


cleared. 


Operand Object Code (Hex) 
Types 1234 
Rj 9540 
Example 
Label Opc Operand Comment 
Field Field Field Field 
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eS 


INSTRUCTIONS 


RETURN 


RTN 


Type 1 Instruction 


Wee ee es 

: 0000 ; 0001 | 8 

BITS 
1 2 


Detailed Description of Instruction Execution 


Control is transferred to the location saved in the topmost entry 
of the return stack. 


The return stack pointer is decremented. 


If the return stack is empty when instruction execution begins, 
control traps to the Debug state with an error code of 1. The 
stack is empty when C(RSCWA) is less than or equal to the 
displacement of the first stack entry. 


Operand Object Code (Hex) 
Types 12 
01 
Example 
Label Opc Operand Comment 
Field Field Field Field 
RTN 
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INSTRUCTIONS 


SET BIT J 


SB Bj 


Type 5 Instruction 


BITS 
l 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Bjr)+Bjd) is set to one. 


Operand Object Code (Hex) 
Types 12345678 
By D8j0oddd 


o is 8 plus the bit offset within the byte. 


Example - 
Label Opc Operand Comment 
Field Field Field Field 
SB BTYPJ 
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INSTRUCTIONS 


SET BIT WITH RELATIVE OFFSET 
SB _Rj,Wi 


Type 5 Instruction 


1 { ! I 1 ( 

' 1101 | 0001 ! Wir! Rj ! Wik! Wid i 32 

‘ ’ I t t ( J ! ! BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Rj)+C(C(Wir)+Wid)) is set to one. 


Operand Wik Object Code (Hex) 


Types L2Zo45 67 8 
Rj,Hi 0 DligjOddd 
Rj,Ti 0 Dlijlddd 
Rj,Di 0) Dlij2dadd 
Rj,Fi 0 Dligjd3ddad 
Example 
Label Opc Operand _ Comment 
Field Field Field Field 
SB R7,HTYPEJ 
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INSTRUCTIONS 


SCAN STRING DECREMENTING UNDER DELIMITER CONTROL WITH COUNT j 


SDDC R1,N 


Type 4 Instruction 


! ! I ) ! ! 

; 0110 ; 1010 ; Ri ; 0000 | N 24 

| t I { ' I I BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) is decremented by one. C(TO) is decremented by one. 
C(C(Ri)) is tested for a match with one of the characters 
specified by N. If the match is not successful, the operation 
is repeated. 
Operand Object Code (Hex) 
Types 123456 
Ri,N 6AiO0nn 
Example 
Label Opc Operand Comment ZW 
Field Field Field Field 
SDDC R9,X‘B' 


Programming Note: Assuming that TO contains zero before the 
instruction is executed, when execution is completed, the number 
of characters scanned will be represented in TO as a negative 
number. 


Programming Note: The older mnemonic form SCDDC Ri,N produces the 
same object code. 
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INSTRUCTIONS 


SCAN STRING DECREMENTING UNDER DELIMITER CONTROL 
SDD Ri,N 


Type 4 Instruction 


| | ! I ] ! 

; 0110 ; 1001 | Rij; 0000! N 24 

! { 1 ' ( 1 t BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) is decremented by one. C(C(R1i)) 1s tested for a match with 
one of the characters specified by N. If the match is not 
successful, the operation is repeated. 


Operand Object Code (Hex) 
Types 123456 
Ri,N 69iO0nn 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
SDD R6,X'C' 


Programming Note: The older mnemonic form SCDD Ri,N produces the 
same object code. 
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INSTRUCTIONS 


SET TO ALL ONES 
SET Wj 


Type 5 Instruction 


Detailed Description of Instruction Execution 


Each bit of C(C(Wjr)+Wjd) is set to a one, that is C(C(Wjr)+Wjd) 
is set to negative one. 


(Hex) 
7 8 


Operand Wik Object Code 
Types 12345678 
Hj 0 C3 4,00d 
Tj 1 c3 301d 
Dj 2 C3 4302d 
Fj 3 c3j303d 
Vj 7 C3j307d 
Example 
Label Opc Operand 
Field Field Field 
SET FTYPJ 
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PRELIMINARY 20SEP88 


SET TO 


oe k 


INSTRUCTIONS 


L 


SHIFT FROM STORAGE 


SHIFT Rj,Ri 


Type 3 Instruction 


i 
l 
; 1110 ; 0101 |; RJ | Ri 16 
l l i 


BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(C(Ri)) is shifted right one bit with zero entering the high- 
order bit position. 


The result replaces C(C(Rj)). 


C(C(Ri)) is not changed. 


Operand Object Code (Hex) 
w Types 1234 
Rj,Ri ES5ji 
Example 
Label Opc Operand Comment 
Field Field Field Field 


SHIFT R9,R5 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-135 


INSTRUCTIONS 


SCAN STRING INCREMENTING, COUNTING DELIMITERS ) 
SICD Ri,Tj,N 


Type 7 Instruction 


l l 
! ! { | I ( 
| 1101 ; 1111 1 Ri ! Tjr ! Tjk Tjd ! 


U { I 
[a oe, ee a ee ee ences Ce eee 
1 2 3 4 5 6 7 8 
ee 
! | 
N I 40 
BITS 
9 10 


Detailed Description of Instruction Execution 


This instruction searches a string for a specified character. Ri 
points at the string, and SCl contains the character. If the 
character is found, the tally Tj is decremented. The search 
continues until either Tj is decremented to zero or a specified 
system delimiter is found. The mask N must specify the search 
character in SCl, and it specifies any system delimiters to stop 
execution. SCO and SC2 are not used by this instruction. 


~<a! 
Operand Wik Object Code (Hex) 
Types 1234567899 
Ri,Tj,N 1 DFijldddnno 

Example 

Label Opc Operand Comment 

Field Field Field Field 

SICD R14,T3,X'42' 


Programming Note: The older mnemonic forms SCCD Ri,Tj,N_ and 
SCD Ri,Tj,N each produce the same object code. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY ?CSED8E 2-125 


INSTRUCTIONS 


SCAN STRING INCREMENTING UNDER DELIMITER CONTROL WITH COUNT 
SIDC Ri,N 


Type 4 Instruction 


! ! ! { I { 

' 0100 ; 1010 ; Ri ;{ 0000 | N , 24 

I 1 | I ( | I BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) is incremented by one. C(TQ0) is decremented by one. 
C(C(Ri)) is tested for a match with one of the characters 
specified by N. If the match is not successful, the operation is 
repeated. 


Operand Object Code (Hex) 
Types 123456 
Ri,N 52i1i0nn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
SIDC R5,9 


Programming Note: Assuming that TO contains zero before the 
instruction is executed, when execution is completed, the number 
of characters scanned will be represented in TO as a negative 
number. 


Programming Note: The older mnemonic form SCDC Ri,N produces the 
same object code. 
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INSTRUCTIONS 
SCAN STRING INCREMENTING UNDER DELIMITER CONTROL ) 
SID Ri,N 


Type 4 Instruction 
(eens ee a rn 


! 1 I ! ' ! 

; 0100 ; 1001 ; Rij; 0000 } N 24 

] ! ] { ( ] ! BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) is incremented by one. C(C(Ri)) is tested for a match with 
one of the characters specified by N. If the match is not 
successful, the operation is repeated. 


Operand Object Code (Hex) 
Types 123456 
Ri,N 49iOnn 

Example 
Label Opc Operand Comment 
Field Field Field Field 
ee ee eee wal! 

SID R15,3 


Programming Note: The older mnemonic form SCD Ri,N produces the 
same object code. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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INSTRUCTIONS 


SCAN STRING UNDER DELIMITER CONTROL ACCUMULATING CHECK SUM 
SIDX R1i,N 


Type 4 Instruction 


ape eg ee ee eS se ee ee 


I I ! | | | 

| 0100 ; 1011 | Rij; 0000 | N 24 

! J i ! | 1 I BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


C(Ri) is incremented by one. C(C(R1)) is tested for a match with 
one of the characters specified by N. If the match is 
unsuccessful, C(C(Ri)) is added to C(TO) and the operation is 
repeated; otherwise, instruction execution terminates. Hence, the 
terminating character is not added to the check sum. 


Operand Object Code (Hex) 
Types 1234536 
Ri,N 4Biodnonn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
S IDX R10,X'A' 
Programming Note: If TO contains zero before instruction 


execution begins, a two-byte check sum of all characters scanned 
will be accumulated in TO. 


Programming Note: The older mnemonic form SCDX Ri,N produces the 
same object code. 
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INSTRUCTIONS 
INCREMENT AND SCAN STRING UNDER TO AND DELIMITER CONTROL 


SITD Ri,N 


Type 4 Instruction 
ae Oe a 


| ! ! ! ! I 

; 0101 ; 0011 ; Rij 0000 | N 24 

t ! ! | ! ! ! BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 


If C(TO0) equals zero initially, no operation is performed. 


C(Ri) is incremented by one. C(TQ) is decremented by one. If 
C(TO) is zero or if C(C(Ri)) matches one of the characters 
specified by N, execution ceases. If the match is not 
successful, the operation is repeated. 
Operand Object Code (Hex) 
Types 123456 
Ri,N 5 3i0QOnn ) 

Example 

Label Opc Operand Comment 

Field Field Field Field 

SITD R15,3 


Programming Note: This instruction may be used to limit the 
maximum number of characters scanned. TQ can be initialized with 
a maximum count before the instruction is executed. After 
execution the number of characters scanned may be computed by 
subtracting the final count in TO from the initial count. 
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INSTRUCTIONS 


SET PCB ADDRESS LINKED 


SPCBL Rj,N 


Type 3 Instruction 


| aan i (aaa 


t J ! J t 

' 0011 |! 1001 ! RJ ! N ! 16 

I ! | | ] BITS 
1 2 3 4 


Detailed Description of Instruction Execution 
This instruction sets a register pointing to a linked workspace 
that starts in one of the process's primary workspace frames. The 
instruction 
adds N to the FID that RO points to and 
sets the C(Rj): 
linked, 


displacement points one byte before data byte one of a 
linked frame, 


FID-field contains the calculated FID. 


Operand Object Code (Hex) 
Types 1234 ° © 
Rj,N 39jon 
Example 
Label Opc Operand Comment 
Field Field Field Field 
SPCBL R7,39 GET DATA STACK READ 


Programming Note: This instruction presumes a knowledge of the 
format of a process's primary workspace. 
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INSTRUCTIONS 


SET PCB ADDRESS UNLINKED 


SPCBU Rj,N 


Type 3 Instruction 


ae er eee yea na eS 8 ee tee ep 


| ! J ! { 

' 0011 ! 1000 | rj | N ! 16 

1 1 I ! ( BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


This instruction sets a registers to point to an unlinked block 


in one of the process's primary workspace frames. 


adds N to the FID that RO points to and 


sets the C(Rj): 


unlinked, 
displacement points to byte zero 
frame, 
FID-field contains the calculated FID. 
Operand Object Code (Hex) 
Types 1234 > 
Rj,N 38jon 
Example 
Label OpcC Operand Comment 
Field Field Field Field 
SPCBU R11,28 GET USER CONTROL BLOCK 


Programming Note: This instruction presumes a knowledge 


format of a process's primary workspace. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-142 


the unlink’ 


The instruction 


of the 


J 


INSTRUCTIONS 


SET PIB ADDRESS 


SP Rj 


Type 3 Instruction 


aaa) (aa aT 


| 1 ] I ' 

' 0010 | 0111 ! Rj} |} 0000! 16 

1 | t I 1 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


The special FID of the PIB is' placed into Rj's FID field. The 
displacement of the PIB in the buffer is placed into Rj's 
displacement field. The flag field is set to X'80' to indicate 
an unlinked frame, and the register is attached. 


Operand Object Code (Hex) 
Types i234 ~ 
Rj 27340 
Example 
Label Opc Operand Comment 
Field Field Field Field 


SP Rll 


Programming Note: Unlike most of the data associated with a 
virtual process, PIBs do not reside on disc; they reside only in 
main memory. In order to allow a virtual process to reference a 
PIB through the address registers with the usual fields, the 
Configurator program puts special FIDs into the Buffer Map for 
the buffers that hold PIBs. These special FIDs have the format: 


X*EFnnnn' 


where nnnn is the process number. 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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INSTRUCTIONS 


SET REGISTER TO ADDRESS 9 


SRA Rj,Wi 


Type 5 Instruction 


! 1 1 1 1 1 { 

; 1100 ; 1000 ; Wir ; Rj | =Wik | Wid 32 

t | t t ] ' | } ' BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


The effective address, C(Wir)+Wid, is computed. The resulting 
effective address replaces C(Rj). 


Operand Wik Object Code (Hex) 
1 2 3 5 7 


Types 12345678 
Rj,Ci 0 C8 ijoddd 
Rj,Hi 0 c8ijoddd 
Rj,Ti 1 cC8s8ijiddd 
Rj,Di 2 C8g8ij2gadaddd 
Rj,Fi 3 CcC8ij3ddd 
Rj,Si 3 C8ij3ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
SRA R15,STYPJ PUT ADR OF STYPJ IN R15 
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INSTRUCTIONS 


STORE ACCUMULATOR 
STORE W3 


Type 5 Instruction 


Ny ee oo ee ee ee ee, ee a a ee he 
! t ' ' ! 
| 1100 | 0010 | Wir ; 0000 ; Wk 


> > 
Ww. 
AQ. 
Ww 
N 


1 2 3 4 5 6 7 8 
Detailed Description of Instruction Execution 
The contents of the 32-bit accumulator (D0) are stored into the 
location defined by the operand if the word type of the operand 
is H,T, or D. That is, C(DO) replaces C(C(Wjr)+Wjd) for operands 
of four bytes or less. For half tally and tally operands, the 
high order bits are lost. 


For a six-byte operand, C(FPQ) replaces C(C(Wjr)+Wjd). 


Operand Wik Object Code (Hex) 
1 5 67 8 


Types 12345678 
Hj 0 Cc2j00ddd 
Tj 1 c2jolddd 
Dj 2 Cc2jo0o2dadd 
Fj 3 C2j0 3 ddd 
Vi 7 C2jy07ddd 
Example 
Label Opc Operand Comment 
Field Field Field Field 
STORE FTYPEJ STORE INTO FPO 
STORE TTYPI STORE INTO (LOW ORDER WORD) 
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INSTRUCTIONS 


SUBTRACT FROM ACCUMULATOR 
SUB Wi 


Type 5 Instruction 


! ! ! ! } ’ ! 

| 1010 ; 0101 | Wir {| 0000 ! Wik } Wid 32 

( I i ( ( ( ! | ! BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 

The integer addressed by the operand is subtracted from the 32- 
bit accumulator (DO) with sign extension. That is, C(D0O) - 
C(C(Wir)+Wid) replaces C(DQ). 


C(ACF) is updated to reflect overflow. 


Operand Wik Object Code (Hex) 
2 7 


Types 12345678 
Hi 0 ASiododgddd 
Ti 1 ASiodiliddd 
Di 2 A5iod?a2zgddd 
Vi 7 A5S5iodgd7vgdddad 
Example 
Label Opc Operand Comment 
Field Field Field Field 
SUB HTYPI SUBTRACT FROM DO 


Programming Note: The mnemonic SUB may be used with F type 
operands (six-byte elements), but the object code generated by 
the assembler is the same as that generated for instruction SUBX. 
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INSTRUCTIONS 


SUBTRACT FROM EXTENDED ACCUMULATOR 


SUBX Wi 


Type 5 Instruction 


l 
| 1010 ; 0100 ; Wir 


1 2 


3 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is subtracted algebraically from C(FP0O) and this 
difference replaces C(FPO). 


replaces C(FPOQ). 


C(ACF) is updated to reflect 


That is, C(FPO) - C(C(Wir)+Wid) 
overflow. 

(Hex) 

7 8 


Operand Wik Object Code 
Types é§ 12345678 
Hi 0 A4iood 
Ti 1 A4iold 
Di 2 A4ioqdg?2d 
Fi 3 A4i03d 
Vi 7 A4iod7d 
Example 
Label Opc Operand 
Field Field Field 
SUBX DTYPI 
SUBX HTYPI 


SUBTRACT FROM FPO 
SUBTRACT (BYTE) FROM FPO 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 


PRELIMINARY 20SEP88 


2-147 


INSTRUCTIONS 


SWAP STORAGE ELEMENTS (_) 


SWAP Wi,Wj 


Type 6 Instruction 


! j j | i | 

' 1111! 1010! Wir! Wir! Wik | Wid } 

| t t ( | | ] ! ! 

7 es i i eee | a a a, (7 

i 2 3 r 5 6 7 5; 
BEE ee eR Peet ee ee ee 
| ! \ 
I Wik | wid i 48 
j ] ] I | BITS 
9 10 li 12 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) and C(C(Wjr)+Wjd) are swapped. 


Operand Wik Wjk Object Code (Hex) 
Types 123456789012 
Ci,Cj 0 0 FAijQOdddOddd = 
Hi,Hj 0 0 FAijQOddqdQddd ” 
Ti,Tj 1 1 FAijldddiddd 
Di,Dj 2 2 FAij2daqadqed2ddd 
Fi,Fj 3 3 FAij3dqdqdad3ddd 
Si,Sj 3 3 FAij3dqddq3dadd 
Vi,Vj 7 7 FAij7?dddaJ7ddd 
Example 
Label OpC Operand Comment 
Field Field Field Field 
SWAP HTYPI,HTYPJ 
SWAP CTYPI,CTYPJ 
SWAP TTYPI,TTYPJ 
SWAP DTYPI,DTYPJ 
SWAP FTYPI,FTYPJ 
SWAP STYPI,STYPJ 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-148 


INSTRUCTIONS 
UNLOCK COMPETING PROCESSES 


UNLOCK N 


Type 2 Instruction 


po a ee oe ee re oe et nee Ie 


I I { t 

+ 0000 ; 0010 | N 16 

j i 4 i 4 BITS 
1 2 3 4 


Detailed Description of Instruction Execution 

This instruction opens locks set by the LOCK N instruction. 
N is the lock number. 

The instruction handles two conditions. 


If lock N contains the unlocked value or the process’ number of 
another process, this instruction falls through to. the next 
instruction in sequence. 


If lock N' contains the process number of the executing process, 
the firmware puts the unlocked value into lock N and searches the 
Priority Queue for all PIBs with the value N inthe PIB lock 
number hold byte. For each PIB with N the firmware removes” the 
lock roadblock. 


Operand Object Code (Hex) 
Types 1234 
N O2nn 
Example 
Label OpcC Operand Comment 
Field Field Field Field 


UNLOCK OVRFLW* 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
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INSTRUCTIONS 


WRITE FILLER CHARACTERS ‘2 
WRITEF 


Type 1 Instruction 


TOOT 

I 

; 0010 ; 1110 |; 8 

BITS 
1 2 


Detailed Description of Instruction Execution 


This instruction causes the CPU firmware to send nulls to the 
process's terminal. 


The characters are transmitted in a manner similar to writing 
data to the terminal using the WRITE instruction, except that no 
registers are involved. 
The following input interface is required : 

Element Description 

TO Number of nulls to send 


C(TO) is undefined after execution of this instruction. ww 


If the process is a TIPH process, this instruction is a NOP. 


Operand Object Code (Hex) 
Types 12 " 
2E 
Example 
Label Opc Operand Comment 
Field Field Field Field 
LOAD 20 SEND 20 NULLS 
WRITEF * TO TERMINAL 
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INSTRUCTIONS 


WRITE NEW LINE 
WRITEOL 


Type 1 Instruction 


ao Oe ee eg 

! 

1 0010 ; 1111 | 8 

BITS 
1 2 


General Description of Instruction Execution 


Because this instruction is quite complex, a general description 
useful to assembly language programmers is presented here, and 
further details are provided below. 


This instruction outputS a Carriage return, line feed and nulls 
to the process's terminal. 


The CPU uses the DELYCNT field in the PIB for the null character 
count. The maximum count that may be specified in DELYCNT is 127. 
Anything larger will cause the instruction to abort into the 
Software Debugger. 


If the process is a TIPH process, that is, if the PIB TRAP.WRITES 
bit is set to l, this instruction traps to the Software Debugger 
and does not perform any I/O. 


Operand Object Code (Hex) 
Types de : 
2F 
Example 
Label Opc Operand Comment 
Field Field Field Field 
WRITEOL * WRITE NEW LINE 
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INSTRUCTIONS 
WRITE NEW LINE (cont) ; ) 
Detailed Description of Instruction Execution 


This instruction uses the same firmware logic as the WRITE 
instruction for putting characters into the output buffer. 


The firmware will first check to see if the corelocked output 
buffer has enough free space for the two end-of-line and DELYCNT 
null characters. If there is not enough room, the output 
roadblock is set, the program counter is set to the WRITEOL 
instruction, the process is deactivated, and the firmware enters 
the Monitor to release the process's time quantum. When the 
output buffer has enough room, the output roadblock will be 
cleared and the WRITEOL instruction will be executed. 


If there is enough room for the characters, the firmware puts 
them into the output buffer. If the buffer is empty when the 
instruction is executed, the firmware sets up the Write task 
descriptor and issues it to the IOP2 to write the characters. 
The firmware then goes to RNI to execute the next instruction. 


For a TIPH process, this instruction sets two PCB fields before 
entering the Software Debugger. 
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INSTRUCTIONS 
WRITE 
WRITE Ri,R} 


Type 3 Instruction 


I { | ] ! 

' 0101 ! 1100 ! Ri ! Rj ! 16 

1 I ! ' I BITS 
1 2 3 4 


General Description of Instruction Execution 


Because this instruction is quite complex, a general description 
useful to assembly language programmers is presented here, and 
further details are provided below. 


This instruction commands the IOP2 to transfer characters to a 
process's terminal. Ri points to the first byte of a character 
String, and Rj} points to the last character of the string. 


If Ri points to a byte in an unlinked frame, Rj must point to the 
same or a subsequent byte in the same frame. If Ri points to a 
byte in a linked frame, Rj must point to the same or a subsequent 
byte in the same linked set. If either of these rules is broken, 
a CROSSING FRAME LIMIT abort is generated. 


This instruction is restricted to virtual mode. If it is executed 
in monitor mode, the Firmware Debugger is entered. 


If the virtual process is a TIPH process, that is, if the PIB 
PHANTOM bit is set to 1, the WRITE instruction traps to the 
Software Debugger and does not perform any 1/O. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj 5 C24 
Example 
Label Opc Operand Comment 
Field Field Field Field 


WRITE R14,R15 


Programming notes: As much as possible, output characters in 
strings, not individually. Use the instruction WRITEOL to output 
carriage return, line feed, and nulls. Use WRITEF to output 
nulls. 
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INSTRUCTIONS 


WRITE (cont) ( 
Detailed Description of Instruction Execution 


This instruction commands the IOP2 to transfer data from main 
memory to a terminal. If the corelocked output buffer is full 
(the buffer pointed to by the OUTPUT.BUF field in the Terminal 
I/O Workspace), the output roadblock is set (OBYTEBLK/ is zeroed} 
and a firmware release quantum entry to the Monitor is’ taken. 
When the output buffer becomes at least half-empty the output 
roadblock will be cleared. When the process is re-activated, the 
WRITE instruction will be re-executed. 


The bytes from Ri to Rj, inclusive, are displayed on the terminal 
of the process executing the WRITE. The details of the WRITE 
instruction's function are governed by the relationship between 
the two registers, the number of characters to output, and the 
amount of free space in the output buffer. These are the 
possible cases: 


1. The first register points before the second and the output 
buffer has room for all the bytes to transmit. If the 
registers are not pointing at the same frame, the frames must 
be linked. 


The CPU firmware moves the data from the virtual process': 
buffer to the corelocked output buffer and advances the 
buffer's producer pointer (the TO.PROD field in the Terminal™ 
I/O Workspace) by the number of bytes moved. If the output 
buffer is empty when the instruction is executed, the Write 
task descriptor is set up and the firmware commands the IOP2 
to write the data to the terminal. The first register (Ri) is 
set pointing to the last byte to be output. The firmware 
returns to RNI to execute the next instruction. 


2. The first register points before the second register and 
there are more characters to transmit than there is free 
space in the output buffer. If the registers are not pointing 
at the same frame, the frames must be linked. 


The firmware moves data from the process's buffer into the 
corelocked output buffer until it is full. If the buffer is 
empty when this instruction is executed, the firmware issues 
a write command to the IOP2. Output roadblock is set. The 
program counter is set pointing at the WRITE instruction. Ri 
is left pointing at the next data to be transmitted, and the 
process is deactivated. The firmware enters the Monitor to 
release the process's time quantum. 
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S 


INSTRUCTIONS 


WRITE (cont) 


When the interrupt signaling completion is received, the 
firmware will advance the output buffer's consumer pointer 
(the TO.CONS field in the Terminal I/O Workspace) by the 
number of bytes written. If there are more data in the 
buffer, the task descriptor is re-issued to write them. If 
that makes the buffer at least half-empty, the output 
roadblock is Cleared; otherwise, the process is not 
reactivated until the next interrupt is received. When the 
process is reactivated, the WRITE instruction is re-executed 
so that output may continue from where it left off. This 
continues until the data are reduced to fewer bytes than the 
free space inthe output buffer, at which time case 1 
applies. 


Use of the WRITE instruction in this way enables a process to 
output an unlimited number of characters with one command. 


3. The registers point to different frames, and the first 
register is in unlinked format; or they point to the same 
frame, and the second register is before the first. 


A CROSSING FRAME LIMIT abort is generated. 


Terminal I/O errors are reported by the IOP2 to the firmware via 
the Status task descriptor and never by the Write task descriptor 
itself. Therefore, when a terminal error is reported, the Write 
task descriptor remains active and the process enters’ the 
Software Debugger. The firmware transfers to Software Debugger 
entry-point 10 for the BREAK key and to entry-point 12 for other 
terminal errors. If one or more of PRGERR (PIB byte l, bit 2) or 
INDEBUG (PIB byte 1, bit 1) or INCCB (PIB byte X'‘'10', bit 0) or 
PHANTOM (PIB byte 0, bit 7) is set to 1, BREAK key is ignored. 


Handshaking errors between the controllers and the CPU may occur 
during I/O operations. These errors may be reported using the 
Write task descriptor as well as the Status task descriptor. 
Whenever the firmware detects) a handshake error, it aborts to 
entry point 20 of the Software Debugger. 


The Monitor may not use the WRITE instruction for terminal 
output; it must issue terminal I/O task descriptors in the same 
manner that it does for other I/O devices. If this instruction 
is executed in monitor mode, the Firmware Debugger will be 
entered. 


If the process is a TIPH process, that is, if the PIB PHANTOM bit 
is set to 1, the WRITE instruction with one exception traps to 
the Software Debugger and does not perform any I/O. The exception 
is when TIPH.OPT is 1. This means the TIPH process is using the T 
option to write to a terminal instead of to a Spooler file. The 
firmware transfers the data to the terminal and does not enter 
the debugger. 
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INSTRUCTIONS 
f 
WRITE (cont) - 


For all other TIPH cases the firmware enters the debugger. First, 
all the error checks are made. PIB field PH.WRITERI1 will be set 
pointing to the first byte of the string to be written. 
PH.WRITER2 will be set pointing to the last byte of the string. 
Ri will be updated to point to the last byte of the string and 
the Software Debugger entered at entry point 19. 
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INSTRUCTIONS 


EXCHANGE CHARACTERS 


XCC Ri,Rj 


Type 3 Instruction 


| i t ' { 

' 1110 ' 1010 ' Ri ! Rj | ~ 16 

| ! ! ! ' BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(C(Ri)) and C(C(Rj)) are exchanged. 

Operand Object Code (Hex) 

Types 1234 

Ri,Rj EAi j 

Example 
Label Opc Operand Comment 
Field Field Field Field 

XCC R8,R9 
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INSTRUCTIONS 


XOR WITH IMMEDIATE 


XOR Rj,N 
XOR N,Rj 


Type 4 Instruction 


! \ { t j I 

' 1000 ! 0011 | Rj} ! 0000! N 1 24 

{ ! I 1 ! ' { BITS 
1 2 3 4 5 6 


Detailed Description of Instruction Execution 
C(C(Rj)) are logically exclusive ORed with N. 


The result replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types 123456 
Rj,N 83j0nn 
N,Rj 83 j0nn 
Example 
Label Opc Operand Comment 
Field Field Field Field 
XOR R8, 
XOR X'C',RS 
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INSTRUCTIONS 


XOR WITH STORAGE 
XOR Rj,Ri 


Type 3 Instruction 


| I | t | 

' 1110 ! 0011 ! RJ} | Ri! 16 

! ! t ] ! BITS 
1 2 3 4 


Detailed Description of Instruction Execution 
C(C(Rj)) are logically exclusive ORed with C(C(Ri)). 


The result replaces C(C(Rj)). 


Operand Object Code (Hex) 
Types 1234 
Rj,Ri E3ji 
Example 
Label Opc Operand Comment 
Field Field Field Field 
XOR R10,R4 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 
PRELIMINARY 20SEP88 2-159 


INSTRUCTIONS 
XOR ELEMENT WITH ELEMENT 
XOR Wi,Wj 


Type 6 Instruction 


le eee en egies citee ee ee ge ee eee eee ee ee ee ee Pea 


l 
l l 
; Llll ;, 1101 ; Wir |; Wjr ; Wik 
I l 


2 3 4 


Detailed Description of Instruction Execution 


C(C(Wir)+Wid) is eXclusively ORed with C(C(Wjr)+Wjd). The result 


replaces C(C(Wjr)+Wjd). 


Operand Wik Wijk 


Types 123456789012 
Ci,Cj 0 0 FDrrQddddodOddd 
Hi,Hj 0 0 FDrrQdddoddd 
Ti,Tj 1 1 FDrridddililddd 
Di,Dj 2 2 FDrr2daddae2dadd 
Fi; F} 3 3 FDrr3daqadqdaq3ddd 
Vi,Vj 7 7 FDrr@7J@dddf7dadd 

Example 

Label Opc Operand Comment 
Field Field Field Field 
XOR HTYPI,HTYPJ 
XOR CTYPI,CTYPJ 
XOR TTYPI,TTYPJ 
XOR DTYPI,DTYPJ 
XOR FTYPI,FTYPJ 


Object Code (Hex) 
5 7 
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0 


INSTRUCTIONS 


EXCHANGE ADDRESS REGISTERS 
XRR Ri,Rj 


Type 3 Instruction 


' ! | I ! 

' 0000 ! 1010 | Ri ! Rj ! 16 

! 1 { { t BITS 
1 2 3 4 


Detailed Description of Instruction Execution 


C(Ri) and C(Rj) are exchanged. All eight bytes of each register 
are exchanged. hence, if Ri was attached, Rj becomes) attached; 
Otherwise it is detached. If Rj was attached, Ri becomes 
attached; otherwise, it is detached. 


Operand Object Code (Hex) 
Types 1234 
Ri,Rj OAi j 
Example 
Label Opc Operand Comment 
Field Field Field Field 
XRR R5,R6 


- 
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( 
ZERO BIT J 


ZB Bj 


Type 5 Instruction 


Se ne es CS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Bjr)+Bjd) is set to zero. 


Operand Object Code (Hex) 
Types 12345678 
Bj DOjOdOoddd 


o is 8 plus the bit offset within the byte. 


Example | 
Label Opc Operand Comment ~ 
Field Field Field Field 

2B BTYPJ 
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INSTRUCTIONS 


ZERO BIT WITH RELATIVE OFFSET 
ZB Rj,Hi 


Type 5 Instruction 
ee 
' l | ! 
; 1101 ; 0000 ; Hir ; j 
y : 


G 
~ 
a 
fo» 
~ 
Q. 
oN) 
tO 


1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 


C(C(Rj)+C(C(Hir)+Hid)) is set to zero. 


Operand Hik Object Code (Hex) 


Types 12345678 
Rj,Hi 0 DOijyOddd 
Example 
Label OpCc Operand Comment 
Field Field Field Field 
ZB RO ,HTYPEJ 
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INSTRUCTIONS 


STORE A ZERO 
ZERO Wj 


Type 5 Instruction 


I i | BITS 
1 2 3 4 5 6 7 8 


Detailed Description of Instruction Execution 
C(C(Wjr)+Wjd) is replaced by binary zeros. 


C(ACF) is NOT changed. 


Operand Wijk Object Code (Hex) 
Types 123456 7.8 
Ca 0 co j0d0ddd 
Hj 0 C0 j0O0ddd 
Tj 1 co j0Olddd 
Dj 2 co j}O02ddd 
Fj 3 CO jO0O3ddd 
Sj 3 c0OjO0O3ddd 
Vi 7 CoOjyjOT7Tdadad 
Example 
Label Opc Operand Comment 
Field Field Field °— Field 
ZERO CTYPJ ZERO THE CONTENTS OF CTYPJ 
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INDEX 


Ol, 
02, 
03, 
04, 
05, 
06, 
07, 
08, 
OA, 
OF, 
12, 
13, 
16, 
be 
25, 
26, 
27, 
2E, 
2F, 
30, 
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opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcodes 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 


2-126 
2-146 
2-95 
Aas a 
2251 
2-41 
2-54 
2-53 
2-158 
2-105 
2-63 
2-62 
2-120 
2-119 
2-50 
2-39 
2-140 
2-147 
2-148 
2733 
2-32 
2-52 
2-9 
2-139 
2-138 
2-66 
y saa | 
2-8 
7 aso 
2-89 
2-88 
2-87 
2-40 
2-73 
2-86 
2-24 
2-135 
2-134 
2-136 
2-34 
2-36 
2-85 
2-83 
2-90 
2-92 
2-91 
2-137 


2-18,2-81 


2-74 
2-70 


AND 


INDEX-1 


opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 


Di 
Fi 


Di,Dj 


RO 
t 
A = 
~ 


1 | 
NNO RH WW WwW Ww WN N NN DD 


NN 
INONNONNNNN NNN ND Ee 
i oO) ee ee | { 


BCNA R1,L ae 


AND Fi,Fj 2-6 
AND Hi,Hj 2-6 BCNE Ci,Rj,L 2-13 
AND N,Rj 2-4 BCNN Ri,L 2=15 
AND Rj,N 2-4 BCNX Ri,L 2-17 
AND Rj,Ri 2-5 BCU N,Ri,L 2-14 
AND Si,Sj 2-6 BCU Ri,Rj,L 2716 
AND Ti,Tj 2-6 BCX Ri,L 217 
AND Vi,Vj 2-6 BCc Ci,Rj,L 2-13 
AND Wi,Wj 2-4,2-5,2-6 BCc N,Ri,L 2-14 
ATT Ri,Rj 2-8 BCc Ri,Rj,L . 2-16 
ATT Rj 2-7 BCCA Ri,L 2-12 
Address register 0 1-6 BCCN Ri,L 2-15 
Address register 1 1-6 BCcX Ri,L 2217 
Address register instructions BDCD 2-24 
2-97 BDLEZ Wj,L 2-25 
Arithmetic Condition Flags BDLEZ Wj,Wi,L 2-21 
1-2 BDL2 Wj,L 2-25 
Arithmetic instructions 1-2 BDLZ Wj,Wi,L 2227 
BL 2-9 BDNZ Wj,L 2-25 
BOQ, opcode 2-100 BDNZ Wj,Wi,L 2227 
Bl, opcode 2-99 BDZ Wj,L 2725 
B2, opcode 2-102 BDZ Wj,Wi,L 2727 
B3, opcode 2-101 BDc Wj,L 2°25 
B4, opcode 2-21 BDc Wj,Wi,L 2-27 
B5, opcode 2-10 BE Ri,Rj,L 2-18 
B6, opcode 2-42 BE Rj,Si,L 21 oO! 
B7, opcode 2-55 BE Si,Rj,L 2-19 
B8, opcode 2-65 BE Wi,Wj,L 2722 
B9, opcode 2-93 BE, opcode 2-58 
BA, opcode 2-97 BF, opcode 2-68 
BASIC DECODE 2-24 BL Wi,Wj,L 2-22 
BBS Bi,L 2-10- BL.E Wi,Wj,L 2-29 
BBS Ri,Hj,L 2-11 BL.L Wi,Wj,L 2-29 
BBZ Bi,L 2-10 BL.LE Wi,Wj,L 2-29 
BBZ Ri,Hj,L 2-11 BL.NE Wi,Wj,L 2-29 
BBc Bi,L 2-10 BL.c Wi,Wj,L 2-29 
BBc Ri,Hj,L 2-11 BLE Wi,Wj,L 2-22 
BC, opcode 2-25 BLEZ Wi,L 2-21 
BCA Ri, L 2-12 BLZ Wi,L 2-21 
BCA Ri,L 2-12 BNZ Wi,L 2-21 
BCE Ci,Rj,L 2-13 BSL L 2732 
BCE N,Ri,L 2-14 BSL M 2-33 
BCE Ri,R4,L 2-16 BSL N,M 2-33 
BCL Ci,Rj,L 2-13 BSLI 2531 
BCL N,Ri,L 2-14 BSTE Ri,Rj,N,L 2-34 
BCL Ri,Rj,L 2-16 BSTU Ri,Rj,N,L 2-34 
BCLE Ci,Rj,L 2-13 BSTc Ri,Rj,N,u 2-34 
BCLE N,Ri,L 2-14 BU Ri,Rj,L 2-18 
BCLE Ri,Rj,L 2-16 BU Rj,Si,L 2-19 
BCN Ri,L 2-15 BU Si,Rj,L 2-19 


7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 


a 
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7.0 VIRTUAL ASSEMBLY LANGUAGE CPU INSTRUCTIONS 


PRELIMINARY 20SEP88 


BU Wi,Wj,L 2-22 
BZ Wi,L 2-21 
Basic Debugger, disable 2-39 
Basic Debugger, enable 2-50 
Bc Ri,Rj,L 2-18 
Bc Rj,Si,L 2-19 
Bc Si,Rj,L 2-19 
Bc Wi,L 2-21 
Bc Wi,Wj,L 2-22 
Branch and stack 2-32 
C(C(Ri)) 1-12 
C(C(Wir)+Wid) 1-12 
C(Ri) 1-12 
C(Wir) 1-12 
C(Wir)+Wid 1-12 
CQ, opcode 2-161 
Cl, opcode 2-106 
C2, opcode 2-142 
C3, opcode 27131 
C6, opcode 2-71 
C8, opcode 2-141 
CA, opcode 2-96 
COMP Ri,Rj,L 2-36 
Character movement 

instructions 2-72 
Codes for operand types 1-10 
Compare code indicators T=15 
Conditional branch 2-16 
Conversion instructions 2-76 
Count in TO control L=3 
DO, opcode 2-159 ,2-160 
Dl, opcode 2-128 
D2, opcode 2-11 
D4, opcode 2-19 
D6, Opcode 2-69 
D7, opcode 2-13 
D8, opcode 2-127 
DA, opcode 2-76 

DATA/BASIC Debugger, disable 
2-39 

DATA/BASIC Debugger, enable 
2-50 
DB, opcode 2-67 
DBDB 2-39 
DCD 2-40 
DCDRR Ri,Rj 2-40 
DE, opcode 2-103 
DEC Dj 2-43 
DEC Dj,Di 2-44 
DEC FJ 2-43 


DQIO Rj,N 


Decrement register 
Delimiter control 
Disable Basic Debugger 


El, 
E2, 
E3, 
E5, 


opcode 
opcode 
opcode 
opcode 
opcode 
opcode 
opcode 


EBDB 


opcode 
opcode 
opcode 
opcode 


ENT M 
ENTI 
EQUBIT 


Element AND instructions 

Element Or instructions 

Element exclusive OR 
instructions 


2-43 
2-44 
2-41 
2-42 
2-44 
2-43 
2-44 
2-43 
2-44 
2-43 
2-44 
2-40 


2-133 


2-45 
2-45 
2-45 
2-45 
2-45 
2-45 
2-46 
2-46 
2-46 
2-46 
2-46 
2-46 
2-47 
2-48 


2-41,2-42 


l=3 
2-39 
2-72 
2-5 
2-108 
2-156 
2-132 
2-16 
2-154 
2-50 
2-112 
2-114 
2-115 
2-111 
2-52 
2-51 
L=2 
2-6 
2-109 


2-157 


Element movement instructions 


INDEX-3 


INDEX 


2-98 
Element size 1-12 
Enable Basic Debugger 2-50 
Exchange registers 2-158 
Fl, opcode 2729 
F2, opcode 2-27 
F3, opcode 2-98 
F4, opcode 2-22 
F5, opcode 2-94 
F6, opcode 2-44 
F7, opcode 2-57 
FA, opcode 2-145 
FB, opcode 2-6 
FC, opcode 2-109 
FD, opcode 2-157 
HALT 2-53 
Hexadecimal to binary 2-85 
INC Dj 2-56 
INC Dj,Di 2-57 
INC Fj,Fi 2-57 
INC Hj 2-56 
INC Hj,Hi 2-57 
INC Rj 2-54 
INC Rj,Wi 2-55 
INC Sj,Si 2-57 
INC Tj 2-56 
INC Tj,Ti 2-57 
INC Vj 2-56 
INC Vj,Vi 2-57 
INC Wj 2-56 
INC Wj,Wi 2=57 
INHIBITH 2-62 
Increment register 2-54,2-55 
Instruction description 
format 1-9 
Instruction set repertoire 
2-1 
Instructions with offset 1-8 
LAD Rj,Si 2-58 
LAD Si,Rj 2-58 
LOAD Di 2-60 
LOAD Fi 2-60 
LOAD Hi 2-60 
LOAD Ti 2-60 
LOAD Vi 2-60 
LOAD Wi 2-60 
LOADA A 2-59 
LOADA Di 2-59 
LOADA Fi 2-59 
LOADA Hi 2-59 


—_ wr cer FRO! BR 


LOADA Ti 

LOADX Di 

LOADX Fi 

LOADX Hi 

LOADX Ti 

LOADX Vi 

LOADX Wi 

LOCK N 

LOCK Tj 

LOCKINH N 

LOWBIT 

LPIB Rj 

Length of operand 
Load address difference 


Lock competing processes 


MBD Ti,Rj 
MBX Ci,Rj 
MBX Di,Rj 
MBX Fi,Rj 
MBX Hi,Rj 
MBX Ti,Rj 
MBX Wi,Rj 
MCC Ci,Rj 


MDD Ri,Rj 
MDDD Ri,Rj,N 
MDDDC Ri,Rj,N 
MDDR Ri,R} 
MDDT Ri,Rj 
MDDTD Ri,Rj,N 
MFBN Ri 

MIC Ri,Rj 

MII Ri,R} 
MIID Ri,Rj,N 
MIIDC Ri,Rj,N 
MIIR Ri,Rj 
MIIT Ri,Rj 
MIITD Ri,Rj,N 
MOV Bi,Bj 

MOV Ci,C} 


RIM MaLHyY CF TF RAILFVTR PM rv Pry FAI MENTS SORTS 


2730 
2-61 
2-61 
2-61 
2°64 
2761 
2-61 
2-63 
2-65 
2762 

eZ 
2-66 
1-14 
2-0 


e762 4 


2763 
2°61 
2-68 
2-68 
2-68 
2-68 
2-68 
2-68 
2-69 


2270 


27 4 
2-72 
2-74 
2=7 3 
2775 
2716 
2-76 
2-76 
2-76 
219 
2-78 
2-77 
2-80 
2-82 
2-81 
2-83 
2-86 
2-89 
2-88 
2-87 
2-90 
2>92 
2-94 
2-94 


2-98° j 


INDEX 


MOV Di,Dj 
MOV Fi,Fj 
MOV Hi,Hj 
MOV Ri,Rj 
MOV Ri,Sj 
MOV Si,Rj 
MOV Si,Sj 
MOV Ti,Tj 
MOV Vi,Vj 
MOV Wi,Wj 
MOVA Si,Rj 


MUL Di 
MUL Fi 


Move bit to bit 
Move register to register 


Move string 


NEG 
NEG 
NEG 
NEG 


NUMBIT 


Normalized address 


ONE Dj 
ONE Fj 
ONE Hj 
ONE Tj 
ONE Vj 
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tad 


? 


2-98 
2-98 
2-98 
2-95 
2-96 
2-97 
2-98 
2-98 
2-98 
2-98 
2=9:3 
2-101 
2-101 
2-101 
2-101 
2-101 
2-101 
2-99 
2-100 
2-102 
2-102 
2-102 
2-102 
2-102 
2-102 
2-103 
2-103 
2-103 
2-103 
2-103 
2-103 
2-85 
2-94 


2-95 
2-92 
2-104 
2-104 
2-104 
2-104 
2-104 
2-104 
2-105 
1-2 
1-7 
2-106 
2-106 
2-106 
2-106 
2-106 


INDEX-5 


2-106 
2-109 
2-109 
2-109 
2-109 
2-107 
27107 
2-108 
2-109 
2-109 
2-109 
LZ 
te 2 
2-126 
2-146 
2-95 
2751 
2-31 
2-41 
2-54 
2-53 
2-158 
2-105 
2-63 
2-62 
2-120 
2-119 
2-50 
2-39 
2-140 
2-147 
2-148 
2-33 
Z2>32 
2-52 
2-9 
2-139 
2-138 
2-66 
2-7) 
2-8 
2-59 
2-89 
2-88 
2-87 
2-40 
2-73 
2-86 
2-24 
2-135 


INDEX 


Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
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2-134 
2-136 
2-34 
2-36 
2-85 
2-83 
2-90 
2-92 
2-91 
2-137 


2-18,2-81 


2-74 
2-70 
2-80 
2-82 
2-150 
2-48 
2-79 
2-78 
2-77 
2-116 
2-117 
2-130 
2-129 
2-4 
2-107 
2-155 
2-75 
2-14 
2-12 
2-15 
2-17 
2-125 
2-113 
2-110 
2-3 
2-2 
2-144 
2-143 
2-43 
2-56 
2-46 
2-45 
2-104 
2-121 
2-47 
2-61 
2-60 
2-100 
2-99 


Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 
Opcode 


ee 


2-101 
2-21 
2-10 
2-42 
2255 
2-65 
2-93 
2297 
Z=25 
2-58 
2-68 

2-161 

2-106 

2-142 

27131 
2271 

2-141 
2-96 


2-159, 2-160 


2-128 
2-11 
2219 
2-69 
2-13 

2-12% 
2-76 
2-67 

2-103 

2-133 
2-72 

2=5 

2-108 

2-156 

2-132 
2-16 

2-154 

2-112 

2-114 

2-115 

2>idl 
2-29 
2-27 
2-98 
2=22 
2-94 
2-44 
2-57 

2-145 

2-6 


2 


INDEX 


Gpcode FC 

Opcode FD 
Operand length indicator 
Operand type codes 
PCB address 2-138, 
PIB address 

POPN 

POPNR Ri 

POPS 

POPSRR Ri,Rj 
PUSHD Ri,Rj 
PUSHDR Ri 

PUSHN 

PUSHNR Ri 

PUSHS Ri 

PUSHS Ri,Rj 
PUSHTS Ri,Rj 
PUSTSR Ri 

QCMD N 

QIO Ri,N 

RDETO Rj 

RDETZ Rj 

READI Di,R}j 
RPROM Rj 

RTN 

Register control 
SB Bj 

SB Rj,Di 

SB Rj,Fi 

SB Rj,Hi 

SB Rj,Ti 

SB Rj,Wi 


SC2 
SCCD Ri,T4,N 
SCD Ri,N 

SCD Ri,Tj,N 
SCDC Ri,N 
SCDD Ri,N 
SCDDC Ri,N 
SCDX Ri,¥ 
SDD Ri,N 
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2-109 
22199 

1-14 

1-10 
2-139 
2-140 
2-110 
2-110 
2-111 
2-111 
2-112 
2-112 
2-113 
2-113 
2-114 
2-114 
2-115 
2-115 
2-116 
2-117 
2-119 
2-120 
2a 121. 
2-125 
2-126 

i= 3 
2-127 
2-128 
2-128 
2-128 
2-128 
2-128 

L=3 

L=3 

1-3 
2=133 
2-135 
2-133 
2-134 
2-130 
2-129 
2-136 
2-130 
2-129 
2-131 
2-131 
2-131 
2-131 
2-231 
2-131 


SHIFT Rj,Ri 
SICD Ri,Tj,N 


SID 


SIDC Ri,N 
SIDX Ri,N 
SITD Ri,N 
SP Rj 
SPCBL Rj,N 
SPCBU Rj,N 


SRA 
SRA 
SRA 


SWAP 
SWAP 
SWAP 
SWAP 
SWAP 
SWAP 
SWAP 
SWAP 
Scan 
Scan 
Set 


Set register to address 
Size of an element 
Storage AND instructions 
Storage OR instructions 
Storage exclusive OR 


INDEX~-7 


Ri,N 


Rj,Ci 
Rj,Di 
Rj,Fi 


instructions 
string 


bit 


22132 
Pian 
27135 
2-134 
2-136 
2-137 
2-140 
2-138 
27139 
2-141 
2-141 
2-141 
2-141 
2-141 
2-141 
2-141 
2-142 
2-142 
2-142 
2-142 
2-142 
2-142 
2-143 
2-143 
2-143 
2-143 
2-143 
2-143 
2-144 
2-144 
2-144 
2-144 
2-144 
2-144 
2-145 
2-145 
2-145 
2-145 
2-145 
2-145 
2-145 
2-145 
L=3 
27-137 
22027 
2-141 
ie 
2-6 
2-109 


INDEX 


instructions 2-157 
Storage movement instructions 
2-98 
Storage register 1l=7 
Store address register 2-96 
String movement 1-32-92 
String scanning 2-137 
UNLOCK N 2-146 
Unconditional branch 2-9 
Unlock processes 2-146 
Unnormalized address Le] 
VALBIT L=2Z 
WRITE Ri,Rj 2-150 
WRITEF 2-147 
WRITEOL 2-148 
XCC Ri,Rj 2-154 
XOR Ci,Cj 2-157 
XOR Di,Dj 2-157 
XOR Fi,Fj 2-157 
XOR Hi,Hj 2-157 
XOR N,Rj 2-155 
XOR Rj,N 2-155 
XOR Rj,Ri 2-156 
XOR Ti,Tj 2-157 
XOR Vi,Vj 2-157 
XOR Wi,Wj 2-157 
XRR Ri,Rj 2-158 
ZB Bj 2°159 
ZB Rj,Hi 2-160 
ZERO Cj 2-161 
ZERO Dj 2-161 
ZERO Fj 2-161 
ZERO Hj 2-161 
ZERO Sj 2-161 
ZERO Tj 2-161 
ZERO Vj 2-161 
ZERO Wj 2-161 
zero bit 2-159 
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